Use hatch-mkdocs and hatch-pip-compile for docs deps

Author: oprypin

.github/workflows/deploy-docs.yml

@@ -16,13 +16,13 @@ jobs:
       - name: Install Python
         uses: actions/setup-python@v4
         with:
-          python-version: '3.12'
+          python-version: '3.11'
       - name: Install dependencies
-        run: pip install --no-deps -r docs/requirements.txt
+        run: pip install --no-deps -r requirements/requirements-docs.txt
       - name: Fetch branch
         run: git fetch origin v1:v1
       - name: Build site
-        run: mkdocs build -f docs/mkdocs.yml
+        run: mkdocs build -f docs/mkdocs.yml --strict
       - name: Upload to GitHub Pages
         uses: actions/upload-pages-artifact@v2
         with:

docs/requirements.in

@@ -0,0 +1,11 @@
+[env]
+requires = [
+    "hatch-mkdocs",
+    "hatch-pip-compile",
+]
+
+[env.collectors.mkdocs.docs]
+path = "docs/mkdocs.yml"
+[envs.docs]
+type = "pip-compile"
+pip-compile-hashes = false

hatch.toml

@@ -1,9 +1,14 @@
 #
-# This file is autogenerated by pip-compile with Python 3.12
-# by the following command:
+# This file is autogenerated by hatch-pip-compile with Python 3.11
 #
-#    pip-compile requirements.in
+# - mkdocs
+# - mkdocs-gen-files
+# - mkdocs-macros-plugin
+# - mkdocs-material
+# - mkdocs-same-dir
+# - pymdown-extensions
 #
+
 babel==2.13.0
     # via mkdocs-material
 certifi==2023.7.22