work

Author: echoboomer

.github/workflows/docs.yml

@@ -1,28 +1,45 @@
-name: Publish Docs
+name: Deploy
 on:
   push:
     branches:
       - main
+  workflow_dispatch:
 permissions:
   contents: write
+  pages: write
+  id-token: write
 jobs:
-  deploy:
+  build_mkdocs:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
-      - name: Configure Git Credentials
-        run: |
-          git config user.name github-actions[bot]
-          git config user.email 41898282+github-actions[bot]@users.noreply.github.com
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
       - uses: actions/setup-python@v5
         with:
-          python-version: '3.12'
-      - run: echo "cache_id=$(date --utc '+%V')" >> $GITHUB_ENV
-      - uses: actions/cache@v4
+          python-version: 3.12
+      - run: pip install \
+          mkdocs-material \
+          mkdocs-glightbox
+      - run: mkdocs gh-deploy --config-file mkdocs.yml --force
+  deploy_mkdocs:
+    needs: build_mkdocs
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          ref: gh-pages
+      - name: Setup Pages
+        uses: actions/configure-pages@v5
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
         with:
-          key: mkdocs-material-${{ env.cache_id }}
-          path: .cache
-          restore-keys: |
-            mkdocs-material-
-      - run: pip install mkdocs-material mkdocs-glightbox
-      - run: mkdocs gh-deploy --force
+          path: '.'
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

docs/deploy/base/deployment.yaml

@@ -0,0 +1,2 @@
+mkdocs-material
+mkdocs-glightbox