try dropping in zensical to replace material for mkdocs

Author: barneyb

.github/workflows/docs.yml

@@ -4,33 +4,41 @@ on:
     branches:
       - master
 permissions:
-  contents: write
+  contents: read
+  pages: write
+  id-token: write
 jobs:
   deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
     runs-on: ubuntu-latest
     defaults:
       run:
         working-directory: ./documentation
     steps:
-      - uses: actions/checkout@v4
-      - name: Configure Git Credentials
-        run: |
-          git config user.name github-actions[bot]
-          git config user.email 41898282+github-actions[bot]@users.noreply.github.com
+      - uses: actions/configure-pages@v5
+      - uses: actions/checkout@v5
       - uses: actions/setup-python@v5
         with:
           python-version: 3.x
-      - run: echo "cache_id=$(date --utc '+%V')" >> $GITHUB_ENV
-      - uses: actions/cache@v4
-        with:
-          key: mkdocs-material-${{ env.cache_id }}
-          path: .cache
-          restore-keys: |
-            mkdocs-material-
+# Zensical recommends no caching for the moment
+#      - run: echo "cache_id=$(date --utc '+%V')" >> $GITHUB_ENV
+#      - uses: actions/cache@v4
+#        with:
+#          key: mkdocs-material-${{ env.cache_id }}
+#          path: .cache
+#          restore-keys: |
+#            mkdocs-material-
       - run: |
           sudo apt-get update
           sudo apt-get install -y zsh
       - run: make johanndoc
         working-directory: ./
-      - run: pip install mkdocs-material mkdocs-minify-plugin
-      - run: mkdocs gh-deploy --force
+      - run: pip install zensical
+      - run: zensical build --clean
+      - uses: actions/upload-pages-artifact@v4
+        with:
+          path: site
+      - uses: actions/deploy-pages@v4
+        id: deployment

Makefile

@@ -20,7 +20,7 @@ not_quite_lisp: not_quite_lisp.jn bin/jnc lib/jstdlib.o
 # utility targets
 
 mkdocs:
-	docker run --rm -it -p 8000:8000 -v ${PWD}/documentation:/docs squidfunk/mkdocs-material
+	docker run --rm -it -p 8000:8000 -v ${PWD}/documentation:/docs zensical/zensical
 
 johanndoc:
 	./johanndoc.sh

documentation/mkdocs.yml

@@ -1,5 +1,5 @@
 site_name: Johann
-copyright: Copyright &copy; 2025 <a href="https://github.com/barneyb">Barney Boisvert</a>
+copyright: Copyright &copy; 2026 <a href="https://github.com/barneyb">Barney Boisvert</a>
 site_url: https://barneyb.github.io/johann
 repo_url: https://github.com/barneyb/johann
 repo_name: barneyb/johann
@@ -40,7 +40,7 @@ theme:
     logo: material/music-rest-quarter
   favicon: images/rest.png
   palette:
-    # Why primary/accept need to be declared thrice is completely unclear.
+    # Why primary/accent need to be declared thrice is completely unclear.
     - media: "(prefers-color-scheme)"
       primary: light green
       accent: light green

documentation/overrides/partials/copyright.html

@@ -8,14 +8,10 @@
     <div class="generator">
         Made with
         <a
-          href="https://www.mkdocs.org/"
-          target="_blank" rel="noopener"
-        >MkDocs</a>
-        and
-        <a
-          href="https://squidfunk.github.io/mkdocs-material/"
-          target="_blank" rel="noopener"
-        >Material</a>
+          href="https://zensical.org/"
+          target="_blank"
+          rel="noopener"
+        >Zensical</a>
     </div>
   {% endif %}
 </div>