Enable mike for docs versioning

.github/workflows/ci.yml

@@ -64,3 +64,5 @@ jobs:
 
       - name: Zig Docs Build
         run: poetry run python -m ziglang build docs
+      - name: MKDocs Build
+        run: poetry run mike deploy develop --push

.github/workflows/publish.yml

@@ -59,16 +59,9 @@ jobs:
       - name: Zig Docs Build
         run: poetry run python -m ziglang build docs
       - name: MKDocs Build
-        run: poetry run mkdocs build
+        run: poetry run mike deploy ${{  github.ref_name }} latest --push
 
       - name: Publish package distributions to PyPI
         uses: pypa/gh-action-pypi-publish@release/v1
 
-      - run: echo "cache_id=$(date --utc '+%V')" >> $GITHUB_ENV
-      - uses: actions/cache@v3
-        with:
-          key: mkdocs-material-${{ env.cache_id }}
-          path: .cache
-          restore-keys: |
-            mkdocs-material-
-      - run: poetry run mkdocs gh-deploy --force
+

mkdocs.yml

@@ -31,9 +31,12 @@ extra:
       link: https://hub.docker.com/r/squidfunk/mkdocs-material/
     - icon: fontawesome/brands/python
       link: https://pypi.org/project/ziggy-pydust/
+  version:
+    provider: mike
 
 plugins:
 - include-markdown
+- mike
 
 markdown_extensions:
   - admonition

pyproject.toml

@@ -27,6 +27,7 @@ black = "^23.7.0"
 ziglang = "^0.11.0"
 mkdocs-material = "^9.2.6"
 mkdocs-include-markdown-plugin = { version = "^6.0.1", python = "<3.13" }
+mike = "^1.1.2"
 
 [tool.poetry.scripts]
 pydust = "pydust.__main__:main"