reorg namespaces to ideas and libs

Author: timothypratley

clay.edn

@@ -7,8 +7,36 @@
                     :branch  "main"}
  :hide-info-line   true
  :hide-ui-header   true
- :aliases {:markdown {:render true
-                      :base-target-path "site"
-                      :format [:quarto :html]
-                      :run-quarto false
-                      :hide-info-line false}}}
+ :aliases
+ {:markdown
+  {:render           true
+   :base-target-path "site"
+   :format           [:quarto :html]
+   :run-quarto       false
+   :hide-info-line   false
+   :quarto           {:format {:html {:theme nil}}}
+   :quarto/expansions
+   {:affiliation
+    {:clojure.core {:name "Clojure.core" :url "https://clojure.org"}
+     :scicloj      {:name "Scicloj" :url "https://scicloj.github.io/"}
+     :clojurecamp  {:name "Clojure Camp" :url "https://clojure.camp/"}
+     :hummi        {:name "Hummi" :url "https://hummi.app"}}
+    :author
+    {:chouser
+     {:name  "Chris Houser"
+      :url   "https://chouser.us/"
+      :links [{:icon "github" :text "GitHub" :href "https://github.com/chouser"}]}
+     :daslu
+     {:name        "Daniel Slutsky"
+      :affiliation [:scicloj]
+      :links       [{:icon "github" :text "GitHub" :href "https://github.com/daslu"}]}
+     :alexmiller
+     {:name        "Alex Miller"
+      :affiliation [:clojure.core]
+      :links       [{:icon "github" :text "GitHub" :href "https://github.com/puredanger"}]}
+     :timothypratley
+     {:name        "Timothy Pratley"
+      :email       "timothypratley@gmail.com"
+      :url         "https://timothypratley.blogspot.com/p/httpswww.html"
+      :affiliation [:hummi :scicloj]
+      :links       [{:icon "github" :text "GitHub" :href "https://github.com/timothypratley"}]}}}}}}

content/_quarto.yml

@@ -10,12 +10,10 @@ website:
     right:
       - posts.qmd
       - ideas.qmd
-      - talks.qmd
-      - tutorials.qmd
-      - pages.qmd
+      - libs.qmd
       - about.qmd
       - icon: github
-        href: https://github.com/timothypratley/clojurecivitas
+        href: "https://github.com/timothypratley/clojurecivitas"
 
 format:
   html:

content/about.qmd

@@ -59,6 +59,10 @@ Exploramus, Communicamus, Crescimus<br>
 <small style="font-size: 1rem; color: #555;">We explore, we share, we grow.</small>
 </div>
 
+Civitas Clojure offers a hassle-free way to host and share your notebooks without the overhead of creating a new project each time.
+By providing a shared, well-organized platform, it lets you focus on your ideas and code while automatically publishing your work to GitHub Pages.
+This streamlines collaboration, increases visibility, and makes contributing simple and efficient—so you can spend less time on setup and more time creating.
+
 Learning technical subjects involves navigating complex webs of concepts.
 Currently, resources for learning Clojure exist as isolated articles, unconnected tutorials, or flat lists that do not
 capture how ideas relate to each other.
@@ -93,28 +97,24 @@ ClojureCivitas can be used as a library to simplify publishing your own garden o
 
 ### File system organization
 
-| Directory           | Description                                                 |
-|---------------------|-------------------------------------------------------------|
-| `src`               | Code for building a website and database                    |
-| `content`           | Notebooks (Clojure and Markdown), images, data files        |
-| `content/posts`     | Time-anchored content (blog posts, announcements, analyses) |
-| `content/pages`     | Timeless or evolving content related to this site           |
-| `content/tutorials` | Learning materials (tutorials, workshops, guides)           |
-| `content/talks`     | Presentation slides and related materials                   |
-| `content/ideas`     | Drafts, experiments, and work-in-progress content           |
-| `site`              | Quarto configuration for the website                        |
-
-Each of `posts`, `pages`, `tutorials`, `talks`, `ideas` is a source-root.
-These directories make it easier to distinguish blog posts from everything else.
+| Directory      | Description                                                          |
+|----------------|----------------------------------------------------------------------|
+| `src`          | Code for building a website and database                             |
+| `content`      | Source root for notebooks (Clojure and Markdown), images, data files |
+| `content/idea` | The `idea` namespace hosts explorations, concepts and insights       |
+| `content/lib`  | The `lib` namespace is tied to libraries, tools, and projects        |
+| `site`         | Temporary build target for the Quarto website                        |
 
-Namespace selection for notebooks follow standard Clojure namespace conventions to avoid conflicts.
+Shared images can go in `content/images`, but prefer images and data files as siblings to your namespace.
 
-Library-related notebooks: Use the library’s namespace prefix (e.g., scicloj.clay.v2.guide.getting-started).
+The difference between a posts and a page is identified by the presence or absence of `date` metadata.
 
-Disambiguation: If a topic exists, qualify with additional context (e.g.,
-scicloj.clay.v2.guide.getting-started.intellij).
+Namespace selection for notebooks follow standard Clojure namespace conventions to avoid conflicts.
+Choose namespaces that fit with the content-first hierarchy.
+Files are grouped by what they’re about (not who wrote them or where they were presented).
+Author, date, tags and categories are included in metadata and will be used for grouping, filter of views.
 
-Dependent utils/modules: Nest under a parent namespace (e.g., ...getting-started.index, ...getting-started.utils).
+Disambiguation: If a topic exists, qualify with additional context.
 
 Civitas invokes [Clay](https://github.com/scicloj/clay) to convert Clojure notebooks into Markdown files, placing them
 in the `site` directory.
@@ -132,18 +132,13 @@ Goal: Align with Clojure’s code organization while allowing organic, practical
 
 ### Topic organization
 
-Notebooks are tagged with a primary topic (first in list) and optional additional topics.
-
-Fixed top-level topics: `:community`, `:core`, `:data`, `:system`, `:tooling`, `:web`.
-
-Subtopics: Semi-open (e.g., :web/frontend implies :web). Expect these to evolve.
-
-Topics are one tagging method; others may emerge.
-
-Tags want to be free:
-https://gwern.net/doc/philosophy/ontology/2005-04-shirky-ontologyisoverratedcategorieslinksandtags.html
+Follow the Quarto convention of categories, tags, and keywords.
+Fixed categories; `community`, `clojure`, `data`, `system`, `tooling`, `web`.
+Tags; flexible, open-ended for finer-grained labeling (e.g. `frontend`, `reagent`).
+Keywords; for SEO or search indexing; typically fewer and focused on discoverability.
 
-But also we can help curate the content with a good set of top-level topics.
+Tags and metadata are the preferred organization principle:
+[Categories, Links, and Tags](https://gwern.net/doc/philosophy/ontology/2005-04-shirky-ontologyisoverratedcategorieslinksandtags.html)
 
 Goal: Constellations, not cabinets.
 

content/db.edn

@@ -1,10 +1,35 @@
-{:topics
+{:author
+ [{:id    :chouser
+   :name  "Chris Houser"
+   :url   "https://chouser.us/"
+   :links [{:icon "github" :text "GitHub" :href "https://github.com/chouser"}]}
+  {:id           :daslu
+   :name         "Daniel Slutsky"
+   :affiliation [:scicloj]
+   :links        [{:icon "github" :text "GitHub" :href "https://github.com/daslu"}]}
+  {:id           :alexmiller
+   :name         "Alex Miller"
+   :affiliation [:clojure.core]
+   :links        [{:icon "github" :text "GitHub" :href "https://github.com/puredanger"}]}
+  {:id           :timothypratley
+   :name         "Timothy Pratley"
+   :email        "timothypratley@gmail.com"
+   :url          "https://timothypratley.blogspot.com/p/httpswww.html"
+   :affiliation [:hummi :scicloj]
+   :links        [{:icon "github" :text "GitHub" :href "https://github.com/timothypratley"}]}]
+
+ :affiliation [{:id :clojure.core :name "Clojure.core" :url "https://clojure.org"}
+                {:id :scicloj :name "Scicloj" :url "https://scicloj.github.io/"}
+                {:id :clojurecamp :name "Clojure Camp" :url "https://clojure.camp/"}
+                {:id :hummi :name "Hummi" :url "https://hummi.app"}]
+
+ :topics
  [{:id        :core
    :desc      "Fundamental language concepts"
    :color     "#E2F0CB"
    :direction 0}
   {:id   :core/syntax
-   :desc "Data structures, special forms, and syntax"}
+   :desc "Data structures special forms and syntax"}
   {:id   :core/fp
    :desc "Functional programming patterns"}
   {:id   :core/async

content/explore.qmd

@@ -0,0 +1,10 @@
+---
+title: "Explore Notebooks"
+listing:
+  contents: .
+  type: default
+  sort: "date desc"
+  filter-ui: true
+  fields: [title, author, date, categories, tags, description]
+---
+Explore all notebooks. Use the filters below to narrow by topic, author, or tag.

content/pages/civitas/view/index.clj content/idea/civitas/explorer.cljcontent/pages/civitas/view/index.clj renamed to content/idea/civitas/explorer.clj

@@ -1,6 +1,8 @@
-^:kindly/hide-code
-^{:clay {:quarto {:format {:html {:page-layout :full}}}}}
-(ns civitas.view.index
+^{:kindly/hide-code true
+  :clay             {:title  "Civitas Explorer"
+                     :quarto {:author :timothypratley
+                              :format {:html {:page-layout :full}}}}}
+(ns idea.civitas.explorer
   (:require [scicloj.kindly.v4.kind :as kind]
             [civitas.db :as db]
             [civitas.geometry :as geom]
@@ -70,14 +72,14 @@
 
 #_^:kindly/hide-code
 #_(kind/hiccup
-  (hex-grid
-    (for [topic (db/topics)]
-      (merge topic {:position  1
-                    :url       nil
-                    :direction 1
-                    :color     (or (:color topic)
-                                   (keyword (name (:id topic))))
-                    :title     (:desc topic)}))))
+    (hex-grid
+      (for [topic (db/topics)]
+        (merge topic {:position  1
+                      :url       nil
+                      :direction 1
+                      :color     (or (:color topic)
+                                     (keyword (name (:id topic))))
+                      :title     (:desc topic)}))))
 
 ^:kindly/hide-code
 (kind/table (db/topics)

…ith_stupid_stuff/z_combinator_gambit.clj …ith_stupid_stuff/z_combinator_gambit.cljcontent/posts/timothypratley/beating_code_interviews_with_stupid_stuff/z_combinator_gambit.clj renamed to content/idea/code_interview/beating/with_stupid_stuff/z_combinator_gambit.clj content/posts/timothypratley/beating_code_interviews_with_stupid_stuff/z_combinator_gambit.clj renamed to content/idea/code_interview/beating/with_stupid_stuff/z_combinator_gambit.clj

@@ -1,6 +1,11 @@
-^{:clay {:quarto {:title "The Z-Combinator Gambit"
-                  :author "Timothy Pratley"}}}
-(ns timothypratley.beating-code-interviews-with-stupid-stuff.z-combinator-gambit)
+^{:kindly/hide-code true
+  :clay             {:quarto {:title    "The Z-Combinator Gambit"
+                              :author   [:chouser :timothypratley]
+                              :date     "2025-05-25"
+                              :category :clojure
+                              :tags     [:lambda-calculus :code-interview]
+                              :keywords [:z-combinator]}}}
+(ns idea.code-interview.beating.with-stupid-stuff.z-combinator-gambit)
 
 ;; Welcome back code champs, number ninjas, and data divers to our first episode of Beating Code Interviews with Stupid Stuff.
 ;; People often send me emails asking, "How can I use lambda calculus to impress people?"

content/posts/util/elk.clj content/idea/graph/layout/elk.cljcontent/posts/util/elk.clj renamed to content/idea/graph/layout/elk.clj

@@ -1,6 +1,11 @@
-(ns util.elk
+^{:kindly/hide-code true
+  :clay             {:title  "Eclipse Layout Kernel"
+                     :quarto {:author   :timothypratley
+                              :category :clojure
+                              :tags     [:graphs :graph-layout]}}}
+(ns idea.graph.layout.elk
   (:require [clojure.data.json :as json]
-            [util.elk-svg :as elk-svg])
+            [idea.graph.layout.elk-svg :as elk-svg])
   (:import (org.eclipse.elk.core RecursiveGraphLayoutEngine)
            (org.eclipse.elk.core.util BasicProgressMonitor)
            (org.eclipse.elk.graph ElkNode)

content/posts/util/elk_svg.clj content/idea/graph/layout/elk_svg.cljcontent/posts/util/elk_svg.clj renamed to content/idea/graph/layout/elk_svg.clj

@@ -1,4 +1,8 @@
-(ns util.elk-svg
+^{:clay {:title "ELK SVG"
+         :quarto {:author   :timothypratley
+                  :category :clojure
+                  :tags     [:graphs :svg :visualization]}}}
+(ns idea.graph.layout.elk-svg
   (:require [clojure.string :as str]
             [scicloj.kindly.v4.kind :as kind]))
 

content/posts/util/print.clj …/idea/print/object/remove_extraneous.cljcontent/posts/util/print.clj renamed to content/idea/print/object/remove_extraneous.clj content/posts/util/print.clj renamed to content/idea/print/object/remove_extraneous.clj

@@ -1,4 +1,8 @@
-(ns util.print
+^{:clay {:title "Clean object printing by removing extraneous"
+         :quarto {:author   :timothypratley
+                  :category :clojure
+                  :tags     [:print-method :objects]}}}
+(ns idea.print.object.remove-extraneous
   (:require [clojure.string :as str])
   (:import (clojure.lang MultiFn)
            (java.io Writer)))