Presenting your namespace

2025-07-30

When sharing ideas
💡
less is more

How to make a slideshow

Add a little metadata to your namespace 🪄

^{:clay {:format [:quarto :revealjs]}
(ns my.awesome.idea)
...

The slides

Write comments

;; Markdown **in my comments**

Code

(+ 1 2)
3

and headings

;; Each heading is a slide

Turn data into HTML

(kind/hiccup
  [:svg {:width "100%"}
   [:circle {:r 40 :cx 50 :cy 50 :fill "lightblue"}]
   [:circle {:r 20 :cx 50 :cy 50 :fill "lightgreen"}]])

Powerful visualizations

(-> (rdatasets/datasets-iris)
    (plotly/layer-point
      {:=x :sepal-length
       :=y :sepal-width}))

That’s it!

Create src/your/idea.clj as a Clojure namespace

Submit a PR to the ClojureCivitas repo

Voilà — you’ve published your presentation.

🌱

Why not turn your next idea into a slideshow?

source: src/scicloj/clay/presenting_presentations.clj