From 55e61221a1e746fb0e8365748237c48e6d75a8b5 Mon Sep 17 00:00:00 2001
From: Silvio Rhatto <rhatto@riseup.net>
Date: Fri, 23 Aug 2024 13:51:05 -0300
Subject: Feat: MkDocs improvements

---
 .gitignore |  1 +
 Makefile   |  2 ++
 mkdocs.yml | 56 +++++++++++++++++++++++++++++++++++++++++++++++++++++++-
 3 files changed, 58 insertions(+), 1 deletion(-)

diff --git a/.gitignore b/.gitignore
index 3093b79..29cf613 100644
--- a/.gitignore
+++ b/.gitignore
@@ -9,3 +9,4 @@ build-area
 puppet/modules
 keyring
 site
+.cache
diff --git a/Makefile b/Makefile
index 9496741..c7b1cf4 100644
--- a/Makefile
+++ b/Makefile
@@ -22,6 +22,8 @@ web:
 web_deploy:
 	@rsync -avz --delete --exclude=keyring site/ debian:/var/sites/debian/www/
 
+docs: web
+
 publish: web web_deploy
 
 keyring:
diff --git a/mkdocs.yml b/mkdocs.yml
index cbd5381..4b5a5bf 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -17,7 +17,61 @@ theme:
   #
   # This option was superseded by the privacy plugin:
   # https://squidfunk.github.io/mkdocs-material/setup/ensuring-data-privacy/#built-in-privacy-plugin
-  font: false
+  #font: false
+
+# Plugins
+# https://www.mkdocs.org/dev-guide/plugins/
+plugins:
+  # Note that this might not be available in the mkdocs-material package from
+  # Debian bookworm (as of 2024-08-23)
+  privacy: {}
+
+# Markdown extensions
+# See https://www.mkdocs.org/user-guide/configuration/#markdown_extensions
+#     https://squidfunk.github.io/mkdocs-material/setup/extensions/
+markdown_extensions:
+  # Footnotes
+  # https://squidfunk.github.io/mkdocs-material/reference/footnotes/
+  footnotes: {}
+
+  # Tasklist handling
+  # https://squidfunk.github.io/mkdocs-material/setup/extensions/python-markdown-extensions/#tasklist
+  pymdownx.tasklist:
+    custom_checkbox: true
+
+  # SuperFences
+  # https://squidfunk.github.io/mkdocs-material/setup/extensions/python-markdown-extensions/#superfences
+  pymdownx.superfences:
+    custom_fences:
+      - name: mermaid
+        class: mermaid
+        format: !!python/name:pymdownx.superfences.fence_code_format
+
+  # Table of Contents configuration
+  # See https://www.mkdocs.org/user-guide/configuration/#markdown_extensions
+  #     https://www.mkdocs.org/user-guide/writing-your-docs/#linking-to-pages
+  toc:
+    permalink: true
+
+  # Attribute Lists
+  # Needed by proper image handling
+  # https://squidfunk.github.io/mkdocs-material/reference/images/
+  # https://squidfunk.github.io/mkdocs-material/setup/extensions/python-markdown/#attribute-lists
+  attr_list: {}
+
+  # Markdown in HTML
+  # Needed by proper image handling
+  # https://squidfunk.github.io/mkdocs-material/reference/images/
+  # https://squidfunk.github.io/mkdocs-material/setup/extensions/python-markdown/#markdown-in-html
+  md_in_html: {}
+
+# Copyright notice
+copyright: Copyleft &copy; 2024 Fluxo Group. See LICENSE for details.
+
+# Extra template parameters
+# https://www.mkdocs.org/user-guide/configuration/#extra
+extra:
+  generator: false
 
 # Navigation
 # https://www.mkdocs.org/user-guide/writing-your-docs/#configure-pages-and-navigation
-- 
cgit v1.2.3