mark drafts for unfinished notebooks

Author: timothypratley

README.md

@@ -26,22 +26,42 @@ See [About Clojure Civitas](https://clojurecivitas.github.io/about).
 Your perspective matters.
 Pull Requests invited, that's the point!
 
-### Write notebooks
+### Creating notebooks
 
-Add a notebook (Clojure namespace or markdown file) in the [`/notebooks`](notebooks) folder.
+Add a Clojure namespace or markdown file in the [`/notebooks`](notebooks) folder.
+
+Add metadata on your namespace to set the title, author, and tags.
+```clojure
+^{:kindly/hide-code true                 ; don't show this code in the notebook
+  :clay             {:title  "About Civitas Metadata"
+                     :quarto {:author   :my-unique-id
+                              :type     :post
+                              :date     "2025-06-05"
+                              :category :clojure
+                              :tags     [:metadata :civitas]}}}
+(ns my.namespace.example)
+```
 
 Configure your author profile in [clay.edn](clay.edn).
 
-**Optional:** Use [Kindly](https://scicloj.github.io/kindly-noted/kindly) annotations in your notebook to make visualizations
+Images can be added to the same folder as the namespace,
+and displayed in the notebook with markdown like `![caption](my-image.jpg)`.
+The first image on the page is used as a preview in the blog listing,
+unless a different image is listed in the metadata.
+
+[Kindly](https://scicloj.github.io/kindly-noted/kindly) annotations in your notebook are rendered as visualizations.
 
 ```clojure
-^kind/hiccup
-[:svg [:circle {:r 50}]]
+^kind/table
+{:tables      ["clean layout" "easy to scan" "communicates clearly"]
+ :charts      ["information-dense" "reveals insights" "pattern-focused"]
+ :hiccup      ["build anything" "custom layouts" "unlimited flexibility"]
+ :many-others ["see the examples" "creative uses" "visual variety"]}
 ```
 
-**Optional:** Use [Clay](https://scicloj.github.io/clay/#setup) to visualize the notebook as you write it.
+**Optional:** [Setup your editor with Clay shortcuts](https://scicloj.github.io/clay/#setup) to visualize the notebook as you write.
 
-**Optional:** Preview the final website
+**Optional:** Preview the final website.
 
 ```sh
 clojure -M:clay -a [:markdown]
@@ -51,12 +71,11 @@ clojure -M:clay -a [:markdown]
 quarto preview site
 ```
 
-[Quarto](https://quarto.org/) is a markdown publishing tool that enhances
-[Pandoc](https://pandoc.org/).
+[Quarto](https://quarto.org/) is the markdown publishing tool.
 
 ### Publish
 
-Merged pull requests are shown on the website via a workflow.
+Merged pull requests are automatically shown on the website.
 
 To create a pull request
 
@@ -65,6 +84,8 @@ To create a pull request
 3. push the branch to your fork
 4. and then open a pull request on GitHub to propose merging your changes into the Civitas main branch.
 
+Please contact @timothypratley if you are having any difficulty submitting a notebook.
+
 ### Building the database
 
 Add to or modify [db.edn](quarto/db.edn)

notebooks/clojure+/print/objects_and_protocols.clj

@@ -1,5 +1,6 @@
 ^{:kindly/hide-code true
-  :clay             {:title  "Printing Objects in Clojure"
+  :clay             {:title  "Printing Objects and Protocols in Clojure"
+                     :draft  true
                      :type   :post
                      :date   "2025-06-09"
                      :quarto {:author :timothypratley}}}

notebooks/clojure/print_object/remove_extraneous.clj

@@ -8,8 +8,7 @@
 (ns clojure.print-object.remove-extraneous
   (:require [clojure.core.async :as async]
             [clojure.string :as str])
-  (:import (clojure.lang MultiFn)
-           (java.io Writer)))
+  (:import (java.io Writer)))
 
 ^:kindly/hide-code ^:kind/hidden
 (set! *warn-on-reflection* true)

notebooks/core/async/flow/exploration.clj

@@ -2,6 +2,7 @@
   :clay             {:title  "Core Async Flow Exploration"
                      :quarto {:author   [:daslu :timothypratley]
                               :type     :post
+                              :draft    true
                               :date     "2025-05-16"
                               :category :clojure
                               :tags     [:core.async :core.async.flow]}}}

notebooks/core/async/flow/visualization.clj

@@ -2,6 +2,7 @@
   :clay             {:title  "Core Async Flow Visualization"
                      :quarto {:author   [:daslu :timothypratley]
                               :type     :post
+                              :draft    true
                               :date     "2025-05-17"
                               :category :clojure
                               :tags     [:core.async :core.async.flow]}}}

notebooks/core/async/flow/visualization/flow_elk.clj

@@ -1,6 +1,7 @@
 ^{:kindly/hide-code true
   :clay             {:quarto {:title    "Flow to ELK data transformation"
                               :author   :timothypratley
+                              :draft    true
                               :category :clojure
                               :tags     [:core.async :core.async.flow]}}}
 

notebooks/graph/layout/elk.clj

@@ -1,6 +1,7 @@
 ^{:kindly/hide-code true
   :clay             {:title  "Eclipse Layout Kernel"
                      :quarto {:author   :timothypratley
+                              :draft    true
                               :category :clojure
                               :tags     [:graphs :graph-layout]}}}
 (ns graph.layout.elk

notebooks/graph/layout/elk_svg.clj

@@ -1,5 +1,6 @@
 ^{:clay {:title "ELK SVG"
          :quarto {:author   :timothypratley
+                  :draft    true
                   :category :clojure
                   :tags     [:graphs :svg :visualization]}}}
 (ns graph.layout.elk-svg

notebooks/scicloj/noj/intro/getting-started-noj.md

@@ -14,7 +14,7 @@ Hello code champs, number ninjas and data divers!
 
 Imagine being able to experiment with Clojure without needing to install tooling, set up editors, or even know about deps.edn
 Sounds like a dream, right?
-Well, dream no more—meet Noj's new Code Reload Executable!
+Well, dream no more—meet [Noj's](https://scicloj.github.io/noj/) new Code Reload Executable!
 
 ![Noj](Noj-icon.svg)