Switch docs to Zensical

Author: a-musing-moose

.github/workflows/docs.yml

@@ -0,0 +1,29 @@
+name: Documentation
+on:
+  push:
+    branches:
+      - master
+      - main
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+jobs:
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/configure-pages@v6
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: 3.x
+      - run: pip install zensical
+      - run: zensical build --clean
+      - uses: actions/upload-pages-artifact@v5
+        with:
+          path: site
+      - uses: actions/deploy-pages@v5
+        id: deployment

.readthedocs.yml

@@ -1,19 +1,18 @@
-version: 2
+ version: 2
 
-build:
+ build:
    os: ubuntu-24.04
    tools:
-      python: "3.13"
+     python: latest
    jobs:
-      pre_create_environment:
-         - asdf plugin add uv
-         - asdf install uv latest
-         - asdf global uv latest
-      create_environment:
-         - uv venv "${READTHEDOCS_VIRTUALENV_PATH}"
-      install:
-         - UV_PROJECT_ENVIRONMENT="${READTHEDOCS_VIRTUALENV_PATH}" uv sync --frozen --group docs
-
-mkdocs:
-  configuration: mkdocs.yml
-  fail_on_warning: false
+     # We recommend using a requirements file for reproducible builds.
+     # This is just a quick example to get started.
+     # https://docs.readthedocs.io/page/guides/reproducible-builds.html
+     install:
+       - pip install zensical
+     build:
+       html:
+         - zensical build
+     post_build:
+       - mkdir -p $READTHEDOCS_OUTPUT/html/
+       - cp --recursive site/* $READTHEDOCS_OUTPUT/html/

Justfile

@@ -23,7 +23,7 @@ build: clean
 # Build docs
 [group('Build')]
 build-docs: clean
-    uv run mkdocs build
+    uv run zensical build
 
 
 # Static analysis
@@ -63,4 +63,4 @@ version:
 tag:
     echo "Tagging version v{{ VERSION }}"
     git tag -a v{{ VERSION }} -m "Creating version v{{ VERSION }}"
-    git push origin v{{ VERSION }}
+    git push origin v{{ VERSION }}

docs/js/readthedocs.js

@@ -57,9 +57,8 @@ dev = [
     "ruff>=0.12.11",
 ]
 docs = [
-    "mkdocs>=1.6.1",
-    "mkdocs-material>=9.7.0",
     "pyyaml-env-tag>=1.1",
+    "zensical>=0.0.44",
 ]
 
 [tool.mypy]