Merge pull request #90 from a-musing-moose/zensical

Switch docs to Zensical

Author: a-musing-moose

.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,7 @@ 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]