🔧 Switch to dependency groups

* Update readthedocs config
* Update GitHub workflow

Author: veit

.github/workflows/docs.yml

@@ -27,7 +27,7 @@ jobs:
       run: |
         uv venv
         echo "$PWD/.venv/bin" >> $GITHUB_PATH
-        uv pip install -e ".[docs]"
+        uv pip install --group=docs
     - name: Build HTML and check links
       run: |
         uv run make html

.readthedocs.yaml

@@ -17,6 +17,10 @@ build:
     - graphviz
   tools:
     python: "3.12"
+  jobs:
+    install:
+      - python -m pip install --upgrade pip
+      - python -m pip install --group=docs
 
 # Build documentation in the docs/ directory with Sphinx
 sphinx:
@@ -26,11 +30,3 @@ sphinx:
 formats:
   - epub
   - pdf
-
-# Optionally declare the Python requirements required to build your docs
-python:
-  install:
-    - method: pip
-      path: .
-      extra_requirements:
-        - docs

docs/404.rst

@@ -0,0 +1,8 @@
+==============
+Page not found
+==============
+
+This page may have been moved.
+
+Please select a page from the side menu or visit our homepage at
+https://www.python4data.science/en/latest/.

docs/conf.py

@@ -32,7 +32,7 @@
 
 project = "Python for Data Science"
 author = "Veit Schiele"
-copyright = f"2019–2024, {author}"
+copyright = f"2019–2025, {author}"
 
 # The full version, including alpha/beta/rc tags
 release = re.sub("^v", "", os.popen("git describe --abbrev=0").read().strip())
@@ -44,17 +44,18 @@
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
 extensions = [
-    "nbsphinx",
     "IPython.sphinxext.ipython_console_highlighting",
-    # 'jupyter_sphinx.execute',
+    # "jupyter_sphinx.execute",
+    "nbsphinx",
+    "notfound.extension",
     "sphinx.ext.autodoc",
-    "sphinx.ext.intersphinx",
     "sphinx.ext.graphviz",
+    "sphinx.ext.intersphinx",
     "sphinx.ext.todo",
-    "sphinxcontrib.cairosvgconverter",
-    "sphinxext.opengraph",
     "sphinx_copybutton",
     "sphinx_inline_tabs",
+    "sphinxcontrib.cairosvgconverter",
+    "sphinxext.opengraph",
 ]
 
 # Add any paths that contain templates here, relative to this directory.

pyproject.toml

@@ -14,24 +14,25 @@ classifiers = [
 ]
 dependencies = []
 
-[project.optional-dependencies]
+[dependency-groups]
 docs = [
-    "sphinx<8.2",
     "furo",
     "ipython",
     "ipywidgets",
+    "matplotlib",
     "nbsphinx",
     "notebook",
-    "sphinxcontrib-svg2pdfconverter",
-    "sphinxext.opengraph", # matplotlib is required for social cards
-    "matplotlib",
+    "sphinx<8.2",
     "sphinx-copybutton",
-    "sphinx_inline_tabs",
     "sphinx-lint",
+    "sphinx-notfound-page",
+    "sphinx_inline_tabs",
+    "sphinxcontrib-svg2pdfconverter",
+    "sphinxext.opengraph", # matplotlib is required for social cards
 ]
 
 dev = [
-    "Python4DataScience[docs]",
+    { include-group = "docs" },
     "pre-commit",
     "codespell",
     "vale",