feat(doc): #919 mermaid support

- Add mermaid support

Signed-off-by: Kevin Amado <[email protected]>

docs/.gitignore

@@ -1 +1,2 @@
 /book
+/mermaid.min.js

docs/book.toml

@@ -9,6 +9,7 @@ src = "src"
 title = "Makes"
 
 [output.html]
+additional-js = ["mermaid.min.js", "mermaid-init.js"]
 default-theme = "ayu"
 edit-url-template = "https://github.com/fluidattacks/makes/edit/main/docs/{path}"
 preferred-dark-theme = "ayu"
@@ -19,3 +20,6 @@ site-url = "/makes"
 [output.html.fold]
 enable = false
 level = 0
+
+[preprocessor.mermaid]
+command = "mdbook-mermaid"

docs/mermaid-init.js

@@ -0,0 +1,4 @@
+mermaid.initialize({
+  startOnLoad: true,
+  theme: "dark",
+});

makes.nix

@@ -50,6 +50,7 @@
       bin = [
         inputs.nixpkgs.just
         inputs.nixpkgs.mdbook
+        inputs.nixpkgs.mdbook-mermaid
         inputs.nixpkgs.reuse
       ];
       source = [outputs."/cli/pypi"];

makes/docs/entrypoint.sh

@@ -4,4 +4,5 @@
 
 # shellcheck shell=bash
 
+mdbook-mermaid install docs/
 mdbook build docs

makes/docs/main.nix

@@ -9,5 +9,8 @@
 makeScript {
   name = "docs";
   entrypoint = ./entrypoint.sh;
-  searchPaths.bin = [inputs.nixpkgs.mdbook];
+  searchPaths.bin = [
+    inputs.nixpkgs.mdbook
+    inputs.nixpkgs.mdbook-mermaid
+  ];
 }