+# https://www.mkdocs.org/user-guide/deploying-your-docs/

+# https://squidfunk.github.io/mkdocs-material/publishing-your-site/#with-github-actions

+name: publish-docs

+on:

+  workflow_dispatch:

+  push:

+    branches:

+      - master

+permissions:

+  contents: write

+jobs:

+  deploy:

+    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

+      - uses: actions/checkout@v4

+      - uses: astral-sh/setup-uv@v5

+        with:

+          version: "0.4.11"

+          enable-cache: true

+      - run: uv python install 3.12

+      - run: uv sync --extra dev

+      - run: echo "cache_id=$(date --utc '+%V')" >> "$GITHUB_ENV"

+      - uses: actions/cache@v4

+        with:

+          key: mkdocs-material-${{ env.cache_id }}

+          path: .cache

+          restore-keys: |

+            mkdocs-material-

+      - run: mkdocs gh-deploy --force