🔧 Use docs:build in readthedocs

Author: jemrobinson

.readthedocs.yaml

@@ -7,15 +7,16 @@ version: 2
 build:
   os: ubuntu-22.04
   tools:
-    python: "3.11"
-
-sphinx:
-  configuration: docs/source/conf.py
+    python: "3.12"
+  commands:
+    - pip install hatch
+    - hatch run docs:rtd
+    - pwd
+    - echo "$READTHEDOCS_OUTPUT"
+    # - ls -alh docs/build/html/
+    # - ls -alh $READTHEDOCS_OUTPUT/html/
+    # - mv docs/build/html/* $READTHEDOCS_OUTPUT/html/
 
 formats:
   - htmlzip
   - pdf
-
-python:
-  install:
-    - requirements: docs/requirements.txt

pyproject.toml

@@ -77,9 +77,11 @@ dependencies = [
 ]
 
 [tool.hatch.envs.docs.scripts]
-build = [
-  # Treat warnings as errors
-  "make -C docs html SPHINXOPTS='-W'"
+build = "sphinx-build -M html -W docs/ docs/build/"
+rtd = [
+  # The readthedocs build needs to also generate PDFs
+  "sphinx-build -M html -W docs/source _readthedocs/html/",
+  "sphinx-build -M latexpdf -W docs/source _readthedocs/pdf/",
 ]
 
 [tool.hatch.envs.lint]