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

.github/workflows/deploy-docs.yml

@@ -13,11 +13,11 @@ 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: mkdocs build
+        run: mkdocs build --strict
       - name: Upload to GitHub Pages
         uses: actions/upload-pages-artifact@v2
         with:

pyproject.toml

@@ -50,6 +50,12 @@ path = "mkdocs_section_index/__init__.py"
 [tool.hatch.build.targets.sdist]
 include = ["/mkdocs_section_index", "/tests"]
 
+[tool.hatch.env]
+requires = [
+    "hatch-mkdocs",
+    "hatch-pip-compile",
+]
+
 [tool.hatch.envs.default.scripts]
 all = [
     "hatch run style:fix",
@@ -97,12 +103,10 @@ format = [
     "ruff format -q mkdocs_section_index tests",
 ]
 
+[tool.hatch.env.collectors.mkdocs.docs]
 [tool.hatch.envs.docs]
-detached = true
-dependencies = [
-    "mkdocs >=1.5",
-    "mkdocs-material >=7.3.6",
-]
+type = "pip-compile"
+pip-compile-hashes = false
 
 [tool.ruff]
 line-length = 100

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

@@ -1,9 +1,11 @@
 #
-# 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 --output-file=docs/requirements.txt -
+# - mkdocs
+# - mkdocs-material
+# - pymdown-extensions
 #
+
 babel==2.13.1
     # via mkdocs-material
 certifi==2023.7.22