Migrate documentation build from MkDocs to Zensical (#2679)

* docs: migrate documentation build from mkdocs to zensical

* docs: update build command to include --clean option for zensical

Author: koxudaxi

.github/workflows/docs.yaml

@@ -22,7 +22,7 @@ jobs:
     - name: Install dependencies
       run: uv sync
     - name: build site
-      run:  mkdocs build --verbose --clean --strict
+      run: zensical build --clean
     - name: Deploy
       uses: peaceiris/actions-gh-pages@v2
       env:

pyproject.toml

@@ -102,8 +102,7 @@ type = [
   { include-group = "test" },
 ]
 docs = [
-  "mkdocs>=1.6",
-  "mkdocs-material>=9.5.31",
+  "zensical>=0.0.11; python_version>='3.10'",
 ]
 black22 = [ "black==22.1" ]
 black23 = [ "black==23.12" ]

tox.ini

@@ -122,8 +122,8 @@ dependency_groups = type
 description = generate documentation
 extras =
 commands =
-    mkdocs build --verbose --clean --strict -d {posargs:{env_tmp_dir}}
-    python -c 'print("Documentation generated at file://{posargs:{env_tmp_dir}}{/}index.html")'
+    zensical build
+    python -c 'print("Documentation generated at file://{tox_root}{/}site{/}index.html")'
 dependency_groups = docs
 
 [testenv:dev]