ci: Use uv rather than a Dockerfile for mkdocs

Author: LukeMathWalker

.github/ci_generator/templates/job_steps/build_docs.jinja

@@ -9,19 +9,13 @@
   run: |
     mkdir -p docs/api_reference
     cp -r target/doc/* docs/api_reference
-- name: Set up QEMU
-  uses: docker/setup-qemu-action@v3
-- name: Set up Docker Buildx
-  uses: docker/setup-buildx-action@v3
-- name: Build and export to Docker
-  uses: docker/build-push-action@v5
-  with:
-    context: docs/
-    load: true
-    tags: pavex-docs
+- name: Install uv
+  uses: astral-sh/setup-uv@v6
+- name: Install the project
+  run: uv sync --locked
 - name: Build docs
   run: |
-    docker run --rm -v ${PWD}:/docs pavex-docs build --strict
+    uv run mkdocs build --strict
 - uses: actions/upload-artifact@v4
   with:
     name: docs
@@ -45,6 +39,7 @@
       --exclude-path="site/api_reference/pavex/time"
       --exclude-path="site/api_reference/help.html"
       --exclude-path="site/api_reference/settings.html"
+      --exclude-path="site/404.html"
       --exclude=".*crate#per-style$"
       --exclude="https://doc.rust-lang.org/*"
       --exclude="https://stackoverflow.com/*"

.github/workflows/docs.yml

@@ -1717,19 +1717,13 @@ jobs:
       run: |
         mkdir -p docs/api_reference
         cp -r target/doc/* docs/api_reference
-    - name: Set up QEMU
-      uses: docker/setup-qemu-action@v3
-    - name: Set up Docker Buildx
-      uses: docker/setup-buildx-action@v3
-    - name: Build and export to Docker
-      uses: docker/build-push-action@v5
-      with:
-        context: docs/
-        load: true
-        tags: pavex-docs
+    - name: Install uv
+      uses: astral-sh/setup-uv@v6
+    - name: Install the project
+      run: uv sync --locked
     - name: Build docs
       run: |
-        docker run --rm -v ${PWD}:/docs pavex-docs build --strict
+        uv run mkdocs build --strict
     - uses: actions/upload-artifact@v4
       with:
         name: docs
@@ -1753,6 +1747,7 @@ jobs:
           --exclude-path="site/api_reference/pavex/time"
           --exclude-path="site/api_reference/help.html"
           --exclude-path="site/api_reference/settings.html"
+          --exclude-path="site/404.html"
           --exclude=".*crate#per-style$"
           --exclude="https://doc.rust-lang.org/*"
           --exclude="https://stackoverflow.com/*"

docs/Dockerfile

@@ -1,5 +1,6 @@
 FROM squidfunk/mkdocs-material:9
 RUN pip install mkdocs-awesome-pages-plugin
+RUN pip install mike
 RUN pip install pygments_ansi_color
 RUN pip install "mkdocs-material[imaging]"
 COPY tools/md_slash ${PACKAGES}/md_slash

docs/tools/md_slash/pyproject.toml

@@ -1,5 +1,5 @@
 [project]
-name = "md-slash"
+name = "md_slash"
 version = "0.1.0"
 readme = "README.md"
 description = "MkDocs extension to convert trailing slashes to <br>"
@@ -8,7 +8,7 @@ requires-python = ">=3.11"
 dependencies = ["Markdown"]
 
 [project.entry-points."markdown.extensions"]
-trailing_slash = "md-slash:makeExtension"
+trailing_slash = "md_slash:makeExtension"
 
 [build-system]
 requires = ["hatchling"]

docs/tools/md_slash/uv.lock

@@ -1,15 +1,20 @@
 site_name: Pavex
-site_url: "https://pavex.dev/"
+site_url: "https://pavex.dev/docs/"
 site_description: "The documentation for Pavex, a framework for building robust APIs in Rust."
 repo_url: "https://github.com/LukeMathWalker/pavex"
 repo_name: "LukeMathWalker/pavex"
 edit_uri: "edit/main/docs/"
 plugins:
   #  - social
   - search
+  - mike:
+      canonical_version: "latest"
   - redirects:
       redirect_maps:
         "index.md": "overview/index.md"
+extra:
+  version:
+    provider: "mike"
 markdown_extensions:
   - admonition
   - pymdownx.details

mkdocs.yml

@@ -0,0 +1,23 @@
+[project]
+name = "pavex"
+version = "0.1.0"
+requires-python = ">=3.13"
+dependencies = [
+    "mike>=2.1.3",
+    "mkdocs-awesome-pages-plugin>=2.10.1",
+    "mkdocs-material>=9.6.23",
+    "mkdocs-redirects>=1",
+    "pymdown-extensions>=10",
+    "pygments-ansi-color>=0.3.0",
+    "pip>=25",
+    "md_slash"
+]
+
+[project.entry-points."markdown.extensions"]
+trailing_slash = "md_slash:makeExtension"
+
+[tool.uv.sources]
+md_slash = { workspace = true }
+
+[tool.uv.workspace]
+members = ["docs/tools/md_slash"]