Use ZDX MkDocs build pipeline

Author: cobycloud

.github/workflows/deploy.yml

@@ -18,15 +18,22 @@ jobs:
         with:
           node-version: 20
           cache: npm
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+      - name: Install uv
+        run: python -m pip install --upgrade uv
+      - name: Install Python docs dependencies
+        run: uv sync --frozen --group dev
       - run: npm ci
       - run: npm run check
       - run: npm run build
       - name: Validate Docker proxy target
         run: npm run proxy:target-check
       - uses: actions/upload-artifact@v4
         with:
-          name: docs-dist
-          path: dist
+          name: docs-site
+          path: site
           if-no-files-found: error
 
   deploy:
@@ -54,8 +61,8 @@ jobs:
           python-version: '3.12'
       - uses: actions/download-artifact@v4
         with:
-          name: docs-dist
-          path: dist
+          name: docs-site
+          path: site
       - name: Install npmctl from PyPI
         run: python -m pip install --upgrade "npmctl>=0.3.10" "npmctl-namecheap>=0.3.10"
       - name: Validate npmctl orchestration secrets

Dockerfile

@@ -1,4 +1,4 @@
 FROM nginx:1.27-alpine
 COPY nginx.conf /etc/nginx/conf.d/default.conf
-COPY dist /usr/share/nginx/html
+COPY site /usr/share/nginx/html
 EXPOSE 80

index.html

@@ -73,11 +73,7 @@ plugins:
 markdown_extensions:
 - admonition
 - pymdownx.details
-- pymdownx.superfences:
-    custom_fences:
-    - name: mermaid
-      class: mermaid
-      format: __PYTHON_TAG_0__
+- pymdownx.superfences
 - pymdownx.tabbed:
     alternate_style: true
 - abbr