Fix sphinx build with Python 3.13 (#839)

sphinx-rtd-theme 2.0.0 is not installable with Python 3.13. Because 3.0.1 is not available in conda-forge yet, we need to install it via pip. We also have to stay with sphinx<8.1.0 for now, because the mermaid extension is not working in the latest version.
atmtools · Oct 11, 2024 · bca68a9 · bca68a9
2 parents 7d2d2a0 + ac27b61
commit bca68a9
Show file tree

Hide file tree

Showing 3 changed files with 12 additions and 6 deletions.
diff --git a/environment-dev-linux.yml b/environment-dev-linux.yml
@@ -29,11 +29,13 @@ dependencies:
         - python-build
         - requests
         - scipy
-        - sphinx
+        - sphinx<8.1.0
         - sphinx-favicon
-        - sphinx_rtd_theme
+        - sphinxcontrib-jquery
         - sphinxcontrib-mermaid
         - xarray
         - zlib
+        - pip:
+          - sphinx-rtd-theme
 channels:
         - conda-forge
diff --git a/environment-dev-mac.yml b/environment-dev-mac.yml
@@ -26,11 +26,13 @@ dependencies:
         - python-build
         - requests
         - scipy
-        - sphinx
+        - sphinx<8.1.0
         - sphinx-favicon
+        - sphinxcontrib-jquery
         - sphinxcontrib-mermaid
-        - sphinx_rtd_theme
         - xarray
         - zlib
+        - pip:
+          - sphinx-rtd-theme
 channels:
         - conda-forge
diff --git a/environment-dev-win.yml b/environment-dev-win.yml
@@ -20,11 +20,13 @@ dependencies:
         - python-build
         - requests
         - scipy
-        - sphinx
+        - sphinx<8.1.0
         - sphinx-favicon
+        - sphinxcontrib-jquery
         - sphinxcontrib-mermaid
-        - sphinx_rtd_theme
         - xarray
         - zlib
+        - pip:
+          - sphinx-rtd-theme
 channels:
         - conda-forge