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

Author: oprypin

.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 && pip install .
+        run: pip install --no-deps -r requirements/requirements-docs.txt && pip install .
       - name: Build site
-        run: mkdocs build
+        run: mkdocs build --strict
       - name: Upload to GitHub Pages
         uses: actions/upload-pages-artifact@v2
         with:

.tools/docs-dependencies.sh

@@ -50,6 +50,12 @@ path = "markdown_callouts/__init__.py"
 [tool.hatch.build.targets.sdist]
 include = ["/markdown_callouts", "/tests"]
 
+[tool.hatch.env]
+requires = [
+    "hatch-mkdocs",
+    "hatch-pip-compile",
+]
+
 [tool.hatch.envs.default.scripts]
 all = [
     "hatch run style:fix",
@@ -92,14 +98,10 @@ format = [
     "ruff format -q markdown_callouts tests",
 ]
 
+[tool.hatch.env.collectors.mkdocs.docs]
 [tool.hatch.envs.docs]
-detached = true
-dependencies = [
-    "mkdocs >=1.5",
-    "mkdocs-material >=7.1.4",
-    "pymdown-extensions >=8.2",
-    "markdown-callouts >=0.1",
-]
+type = "pip-compile"
+pip-compile-hashes = false
 
 [tool.ruff]
 line-length = 100

pyproject.toml

@@ -1,9 +1,12 @@
 #
-# 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 -
+# - markdown-callouts
+# - mkdocs
+# - mkdocs-material
+# - pymdown-extensions
 #
+
 babel==2.13.1
     # via mkdocs-material
 certifi==2023.7.22