Use hatch on RTD (#402)

* use hatch on RDT

* define python version

* Fix output path

* fail-on-warning by default

* update sphinx version

---------

Co-authored-by: Philipp A. <flying-sheep@web.de>

Author: grst

.github/workflows/test.yaml

@@ -61,7 +61,7 @@ jobs:
       - name: Build the documentation
         run: |
           cd "$PROJECT_ROOT"
-          hatch run docs:build -W
+          hatch run docs:build
 
   test-scripts:
     runs-on: ubuntu-latest

{{cookiecutter.project_name}}/.readthedocs.yaml

@@ -1,16 +1,15 @@
 # https://docs.readthedocs.io/en/stable/config-file/v2.html
 version: 2
 build:
-  os: ubuntu-20.04
+  os: ubuntu-24.04
   tools:
-    python: "3.10"
-sphinx:
-  configuration: docs/conf.py
-  # disable this for more lenient docs builds
-  fail_on_warning: true
-python:
-  install:
-    - method: pip
-      path: .
-      extra_requirements:
-        - doc
+    python: "3.12"
+  jobs:
+    create_environment:
+      - asdf plugin add uv
+      - asdf install uv latest
+      - asdf global uv latest
+    build:
+      html:
+        - uvx hatch run docs:build
+        - mv docs/_build $READTHEDOCS_OUTPUT

{{cookiecutter.project_name}}/pyproject.toml

@@ -39,7 +39,7 @@ optional-dependencies.doc = [
   "pandas",
   # Until pybtex >0.24.0 releases: https://bitbucket.org/pybtex-devs/pybtex/issues/169/
   "setuptools",
-  "sphinx>=4",
+  "sphinx>=8.1",
   "sphinx-autodoc-typehints",
   "sphinx-book-theme>=1",
   "sphinx-copybutton",
@@ -68,7 +68,7 @@ features = [ "dev" ]
 
 [tool.hatch.envs.docs]
 features = [ "doc" ]
-scripts.build = "sphinx-build -M html docs docs/_build {args}"
+scripts.build = "sphinx-build -M html docs docs/_build -W {args}"
 scripts.open = "python -m webbrowser -t docs/_build/html/index.html"
 scripts.clean = "git clean -fdX -- {args:docs}"