docs: move docs reqs to toml

.readthedocs.yaml

@@ -14,16 +14,14 @@ build:
   os: ubuntu-24.04
   tools:
     python: "3.13"
+  jobs:
+    create_environment:
+      - asdf plugin add uv
+      - asdf install uv latest
+      - asdf global uv latest
+    install:
+      - UV_PROJECT_ENVIRONMENT=$READTHEDOCS_VIRTUALENV_PATH uv sync --no-default-groups --group docs
 
 # Build documentation in the "docs/" directory with Sphinx
 sphinx:
   configuration: docs/conf.py
-# Optionally, but recommended,
-# declare the Python requirements required to build your documentation
-# See https://docs.readthedocs.io/en/stable/guides/reproducible-builds.html
-python:
-  install:
-    - method: pip
-      path: .
-      extra_requirements:
-        - docs

docs/conf.py

@@ -96,6 +96,9 @@
 }
 
 html_theme = "pydata_sphinx_theme"
+html_theme_options = {
+    "header_links_before_dropdown": 4,
+}
 
 html_static_path = ["_static"]
 html_css_files = ["custom.css"]

docs/index.rst

@@ -28,8 +28,9 @@ User Guide
    :maxdepth: 1
 
    Examples <examples/solar_wind_example>
+   Changelog <changelog>
+   Contributing Guide <CONTRIBUTING>
+
    Complete OMNI variables <omni_variables>
    SuperMAG electrojet indices <supermag_indices>
    SuperMAG substorm-onset catalogues <supermag_substorms>
-   Changelog <changelog>
-   Contributing Guide <CONTRIBUTING>

pyproject.toml

@@ -1,3 +1,3 @@
 # SPDX-FileCopyrightText: 2025 GFZ Helmholtz Centre for Geosciences
 #
 # SPDX-License-Identifier: Apache-2.0
@@ -47,11 +47,10 @@
     "wget>=3.2",
     "xarray>=2024.10",
 ]
-dynamic = ["optional-dependencies", "version"]
+dynamic = ["version"]
 
 [tool.setuptools.dynamic]
 version = { attr = "swvo.__version__" }
-optional-dependencies.docs = { file = ["docs/requirements.txt"] }
 
 [project.urls]
 Homepage = "https://github.com/GFZ/SWVO"
@@ -137,3 +136,16 @@
     "pytest>=9.0.2",
     "pytest-mock>=3.15.1",
 ]
+docs = [
+    "sphinx-copybutton",
+    "sphinx-github-changelog",
+    "sphinx",
+    "pydata-sphinx-theme",
+    "myst-parser",
+    "alabaster",
+    "docutils",
+    "imagesize",
+    "numpydoc",
+    "linkify-it-py",
+    "nbsphinx",
+]

swvo.def

@@ -15,7 +15,6 @@ From: astral/uv:python3.12-bookworm-slim
     swvo /opt/swvo/
     pyproject.toml /opt/swvo/
     uv.lock /opt/swvo/
-    docs/requirements.txt /opt/swvo/docs/requirements.txt
     download_daily_files.py /opt/swvo/
 
 %environment