docs: use uv & 3.13 for build (hynek#690)

* docs: use uv & 3.13 for build

* Add unused config to appease RTD

Author: hynek

.github/workflows/ci.yml

@@ -184,7 +184,7 @@ jobs:
       - uses: actions/setup-python@v5
         with:
           # Keep in sync with tox.ini/docs & .readthedocs.yaml
-          python-version: "3.12"
+          python-version: "3.13"
       - uses: hynek/setup-cached-uv@v2
 
       - run: >

.readthedocs.yaml

@@ -5,20 +5,16 @@ build:
   os: ubuntu-lts-latest
   tools:
     # Keep version in sync with tox.ini/docs and ci.yml/docs.
-    python: "3.12"
-  jobs:
-    # Need the tags to calculate the version.
-    post_checkout:
-      - git fetch --tags
+    python: "3.13"
+  commands:
+    # Need the tags to calculate the version (sometimes).
+    - git fetch --tags
+    - asdf plugin add uv
+    - asdf install uv latest
+    - asdf global uv latest
 
-    # Replace versions in sponsor URLs.
-    pre_build:
-      - python -Im pip install tox-uv
-      - python -Im tox run -e docs-sponsors
+    - uvx --with tox-uv tox run -e docs-sponsors
+    - uvx --with tox-uv tox run -e docs -- $READTHEDOCS_OUTPUT
 
-python:
-  install:
-    - method: pip
-      path: .
-      extra_requirements:
-        - docs
+sphinx:
+  configuration: docs/conf.py

tox.ini

@@ -45,11 +45,12 @@ commands =
 
 [testenv:docs]
 # Keep base_python in sync with ci.yml/docs and .readthedocs.yaml.
-base_python = py312
+base_python = py313
 extras = docs
 commands =
-    sphinx-build -n -T -W -b html -d {envtmpdir}/doctrees docs docs/_build/html
-    sphinx-build -n -T -W -b doctest -d {envtmpdir}/doctrees docs docs/_build/html
+    sphinx-build -n -T -W -b html -d {envtmpdir}/doctrees docs {posargs:docs/_build/}html
+    sphinx-build -n -T -W -b doctest -d {envtmpdir}/doctrees docs {posargs:docs/_build/}html
+
 
 [testenv:docs-watch]
 package = editable