Fix the documentation build

.pre-commit-config.yaml

@@ -7,7 +7,7 @@
 
 repos:
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.9.3
+    rev: v0.11.0
     hooks:
       - id: ruff
         args:
@@ -25,7 +25,7 @@ repos:
   #         - --install-types
   #         - --non-interactive
   - repo: https://github.com/codespell-project/codespell
-    rev: v2.4.0
+    rev: v2.4.1
     hooks:
       - id: codespell
         additional_dependencies: [tomli]
@@ -68,12 +68,12 @@ repos:
       - id: rst-directive-colons
       - id: text-unicode-replacement-char
   - repo: https://github.com/PyCQA/isort # TODO: remove as soon as ruff is stable
-    rev: 5.13.2
+    rev: 6.0.1
     hooks:
       - id: isort
         args: [--profile=black]
   - repo: https://github.com/PyCQA/bandit
-    rev: 1.8.2
+    rev: 1.8.3
     hooks:
       - id: bandit
         exclude: "^tests/.*|examples/.*"

Makefile

@@ -27,7 +27,7 @@ build:
 .PHONY: dev
 dev:
 	@git lfs install
-	$(PYTHON) -m pip install -e ".[dev,test,jupyter,examples]"
+	$(PYTHON) -m pip install -e ".[dev,test,jupyter,examples]" -r doc/requirements.txt
 
 ## install		Install the package
 ##

doc/requirements.txt

@@ -1,9 +1,10 @@
-cloup
+click~=8.1
+cloup~=3.0
 ipython
 nbsphinx
 netCDF4>=1.6.1
 numpy
 setuptools_scm
-sphinx
+sphinx<8.2.0 # doesn't work with nbsphinx
 sphinx-rtd-theme
 xarray>=2022.11.0

pyproject.toml

@@ -26,8 +26,8 @@ dependencies = [
   "xarray>=2022.11.0",
   "netCDF4>=1.6.1",
   "numpy",
-  "click",
-  "cloup",
+  "click~=8.1",
+  "cloup~=3.0",
 ]
 keywords = [
   "climate-science",
@@ -102,10 +102,6 @@ dev = [
   # building
   "setuptools_scm",
   "build",
-  # documentation
-  "sphinx",
-  "sphinx-rtd-theme",
-  "nbsphinx",
   # linting
   "pylint",
   "flake8",