Merge branch 'main' into data-engineering-clojure-support-for-popular-data-tools

Author: alza-bitz

deps.edn

@@ -11,7 +11,7 @@
   metosin/malli                               {:mvn/version "0.19.1"}
   clj-fuzzy/clj-fuzzy                         {:mvn/version "0.4.1"}
   clj-thamil/clj-thamil                       {:mvn/version "0.2.0"}
-  org.scicloj/clay                            {:mvn/version "2-beta53"
+  org.scicloj/clay                            {:mvn/version "2-beta54"
                                                #_#_:git/url "https://github.com/scicloj/clay.git"
                                                #_#_:git/sha "b5ebd1a98d7deba6c165a72077ffa08554f4c93a"}
   org.eclipse.elk/org.eclipse.elk.core        {:mvn/version "0.10.0"}

site/db.edn

@@ -94,7 +94,12 @@
    :image       "https://avatars.githubusercontent.com/u/1161048?v=4"
    :email       ""
    :affiliation [:scicloj]
-   :links       [{:icon "github" :href "https://github.com/alza-bitz"}]}]
+   :links       [{:icon "github" :href "https://github.com/alza-bitz"}]}
+  {:id          :emilbengtsson
+   :name        "Emil Bengtsson"
+   :url         "https://emil0r.com"
+   :image       "https://avatars.githubusercontent.com/u/49733?v=4"
+   :links       [{:icon "github" :href "https://github.com/emil0r"}]}]
 
  :affiliation
  [{:id   :clojure.core

site/styles.scss

@@ -30,7 +30,8 @@ figcaption {
   text-align: center;
 }
 
-body.quarto-dark .js-plotly-plot {
+body.quarto-dark .js-plotly-plot,
+body.quarto-dark .mermaid {
   filter: invert(100%) hue-rotate(180deg);
 }
 
@@ -85,4 +86,4 @@ table {
 /* Add space between main headings and descriptions */
 #title-block-header.quarto-title-block.default .quarto-title .title {
   margin-bottom: 0.5em;
-}
+}

src/scicloj/clay/mermaid.clj

@@ -0,0 +1,30 @@
+^{:kindly/hide-code true
+  :clay             {:title  "Mermaid.js"
+                     :format [:quarto :html]
+                     :quarto {:author      :emilbengtsson
+                              :description "Explain complex concepts with mermaid.js"
+                              :type        :post
+                              :date        "2025-09-05"
+                              :image       "mermaid.png"
+                              :category    :clay
+                              :tags        [:clay :workflow]}}}
+(ns scicloj.clay.mermaid
+  (:require [scicloj.kindly.v4.kind :as kind]))
+
+
+;; ## A picture is worth a thousand words
+
+(kind/mermaid "flowchart LR
+ Concept --> easy{Easy to understand?}
+ easy -->|Yes| Understanding
+ easy -->|No| Diagram
+ easy -->|No| wall(Wall of text)
+ Diagram --> Understanding
+ wall -->|Didn't get it| Concept
+ wall -->|Finally| Understanding")
+
+;;
+;; With [mermaid.js](https://mermaid.js.org/) you can now use words to generate
+;; a picture. One of the trickier aspects in explaining complex ideas/concepts,
+;; is the infliction point where words start to pile up towards dizzying heights
+;; and you lose sight of what what you wanted to communicate.