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

.github/workflows/deploy-docs.yml

@@ -15,9 +15,9 @@ jobs:
       - name: Install Python
         uses: actions/setup-python@v4
         with:
-          python-version: '3.x'
+          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: Build site
         run: LINT=true mkdocs build --strict
       - name: Upload to GitHub Pages

hatch.toml

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

docs/requirements.txt → requirements/requirements-docs.txt

@@ -1,9 +1,18 @@
 #
-# This file is autogenerated by pip-compile with Python 3.11
-# by the following command:
+# This file is autogenerated by hatch-pip-compile with Python 3.11
 #
-#    pip-compile docs/requirements.in
+# - markdown-callouts
+# - mkdocs
+# - mkdocs-code-validator
+# - mkdocs-gen-files
+# - mkdocs-literate-nav
+# - mkdocs-material
+# - mkdocs-section-index
+# - mkdocstrings
+# - mkdocstrings-crystal
+# - pymdown-extensions
 #
+
 babel==2.13.1
     # via mkdocs-material
 certifi==2023.7.22