trying to make readthedocs work with uv

Author: paolomorettin

.readthedocs.yaml

@@ -9,18 +9,20 @@ version: 2
 
 build:
 
-  os: "ubuntu-24.04"
+  os: ubuntu-24.04
 
   tools:
 
     python: "3.12"
 
-  commands:
-  
-    - pip install uv
-    - cd docs
-    - uv run make html
-    - cd ..
+  jobs:
+    create_environment:
+      - pip install uv
+      - uv sync
+
+    build:
+      html:
+        - make -C docs/source html BUILDDIR=$READTHEDOCS_OUTPUT
 
 # Build documentation in the "docs/" directory with Sphinx
 

docs/Makefile

@@ -10,11 +10,11 @@ BUILDDIR      = build
 
 # Put it first so that "make" without argument is like "make help".
 help:
-	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+	@uv run $(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
 
 .PHONY: help Makefile
 
 # Catch-all target: route all unknown targets to Sphinx using the new
 # "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
 %: Makefile
-	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+	@uv run $(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)