Add slideshow demo

Author: philippamarkovics

deps.edn

@@ -1,13 +1,14 @@
 {:paths ["dev" "notebooks" "resources"]
  :deps {io.github.nextjournal/clerk {:mvn/version "0.8.442"}
+        io.github.nextjournal/clerk-slideshow {:git/sha "82b3b83ca456995250bdb99deceb5a24fdd75439"}
 
         ;; input various external data formats
-        com.github.seancorfield/next.jdbc  {:mvn/version "1.2.659"}
-        meta-csv/meta-csv                  {:mvn/version "0.1.0"}
-        org.xerial/sqlite-jdbc             {:mvn/version "3.34.0"}
-        dk.ative/docjure                   {:mvn/version "1.16.0"}
-        clojusc/wordnet                    {:mvn/version "1.2.0"}
-        clj-jgit/clj-jgit                  {:mvn/version "1.0.2"}
+        com.github.seancorfield/next.jdbc {:mvn/version "1.2.659"}
+        meta-csv/meta-csv {:mvn/version "0.1.0"}
+        org.xerial/sqlite-jdbc {:mvn/version "3.34.0"}
+        dk.ative/docjure {:mvn/version "1.16.0"}
+        clojusc/wordnet {:mvn/version "1.2.0"}
+        clj-jgit/clj-jgit {:mvn/version "1.0.2"}
 
         ;; some statistical routines
         kixi/stats {:mvn/version "0.5.4"}
@@ -16,9 +17,9 @@
         sicmutils/sicmutils {:mvn/version "0.22.0"}
 
         ;; semantic web goodies and box/arrow graphs
-        jackrusher/mundaneum               {:git/url "https://github.com/jackrusher/mundaneum/"
-                                            :git/sha "d2c934a12388d88ddb3e53fef92ec2eef97d6140"}
-        arrowic/arrowic                    {:mvn/version "0.1.1"}
+        jackrusher/mundaneum {:git/url "https://github.com/jackrusher/mundaneum/"
+                              :git/sha "d2c934a12388d88ddb3e53fef92ec2eef97d6140"}
+        arrowic/arrowic {:mvn/version "0.1.1"}
 
         ;; 2D drawing routines
         clojure2d/clojure2d                {:mvn/version "1.4.4"}
@@ -33,6 +34,7 @@
    ;; notebooks to be built, accepts globs patterns
    :exec-args {:bundle? false
                :paths ["index.md"
+                       "notebooks/slideshow.md"
                        "notebooks/introduction.clj"
                        "notebooks/data_science.clj"
                        "notebooks/images.clj"

notebooks/slideshow.md

@@ -0,0 +1,64 @@
+# Hello there 👋
+
+`clerk-slideshow` enables you to create beautiful interactive slide decks
+using Clerk notebooks.
+
+---
+
+## How does it work?
+
+Simply require `clerk-slideshow`…
+
+```clojure
+  (ns simple-slideshow
+    (:require [nextjournal.clerk :as clerk]
+      [nextjournal.clerk-slideshow :as slideshow]))
+```
+
+…and add it to Clerk’s existing viewers:
+
+```clojure
+  ^{::clerk/viewer clerk/hide-result}
+  (clerk/add-viewers! [slideshow/viewer])
+```
+
+---
+
+## What now?
+
+With that in place, you can use Markdown comments to write your slides’ content.
+Use Markdown rulers (`---`) to separate your slides. You can use everything that
+you’ll normally use in your Clerk notebooks:
+Markdown, plots, code blocks, you name it.
+
+Press `←` and `→` to navigate between slides or `Escape` to get an overview.
+
+Now some demos 👉
+
+---
+
+## 📊 A Plotly graph
+
+```clojure
+  ^{::clerk/visibility :hide}
+  (clerk/plotly {:data [{:z [[1 2 3] [3 2 1]] :type "surface"}]})
+```
+
+---
+
+## 📈 A Vega Lite graph
+
+```clojure
+  ^{::clerk/visibility :hide}
+(clerk/vl {:width 650 :height 400 :data {:url "https://vega.github.io/vega-datasets/data/us-10m.json"
+                                         :format {:type "topojson" :feature "counties"}}
+           :transform [{:lookup "id" :from {:data {:url "https://vega.github.io/vega-datasets/data/unemployment.tsv"}
+                                            :key "id" :fields ["rate"]}}]
+           :projection {:type "albersUsa"} :mark "geoshape" :encoding {:color {:field "rate" :type "quantitative"}}})
+```
+
+---
+
+## And that’s it for now! 👋
+
+More demos will follow soon!