ci: build docs site with mkdocs

workflow copied with:
    ccbr_actions use-example docs-mkdocs

.github/workflows/docs-mkdocs.yml

@@ -0,0 +1,28 @@
+name: docs
+# this workflow requires:
+#  - an mkdocs config file (`mkdocs.yml`)
+#  - website dependencies in `docs/requirements.txt`
+on:
+  workflow_dispatch:
+  release:
+    types:
+      - published
+  push:
+    branches:
+      - main
+    paths:
+      - "docs/**"
+      - "**.md"
+      - .github/workflows/docs-mkdocs.yml
+      - mkdocs.yml
+
+jobs:
+  mkdocs:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: CCBR/actions/mkdocs-mike@v0.1
+        with:
+          github-token: ${{ github.token }}

docs/requirements.txt

@@ -0,0 +1,13 @@
+mkdocs
+#https://pypi.org/project/mkdocs-git-revision-date-localized-plugin/
+mkdocs-git-revision-date-localized-plugin
+#https://pypi.org/project/mkdocs-minify-plugin/
+mkdocs-minify-plugin
+#https://pypi.org/project/mkdocs-git-revision-date-plugin/
+mkdocs-git-revision-date-plugin
+#https://pypi.org/project/mkdocs-material/
+mkdocs-material
+#https://pypi.org/project/mkdocs-material-extensions/
+mkdocs-material-extensions
+#https://github.com/jimporter/mike
+mike