Update readthedocs build config (#74)

* Update readthedocs build config to mambaforge-22.9

* Pin versions of sphinx and optional extensions

As recommended for reproducible builds on readthedocs:
https://docs.readthedocs.io/en/stable/guides/reproducible-builds.html
and to ensure that our docs build works with readthedocs changes to default
project dependencies:
https://blog.readthedocs.com/defaulting-latest-build-tools/

.readthedocs.yaml

@@ -3,7 +3,7 @@ version: 2
 build:
   os: ubuntu-22.04
   tools:
-    python: "mambaforge-4.10"
+    python: "mambaforge-22.9"
 
 conda:
   environment: envs/environment-rtd.yaml

envs/environment-dev.yaml

@@ -27,10 +27,10 @@ dependencies:
   - pytest-cov
   - tomli
 
-  # For documentation
-  - sphinx
-  - sphinx_rtd_theme=1.2
-  - sphinx-notfound-page
+  # Sphinx and extensions
+  - sphinx=7.2.6
+  - sphinx-notfound-page=1.0.0
+  - sphinx-rtd-theme=2.0.0
 
   - pip:
     - arrow

envs/environment-rtd.yaml

@@ -14,9 +14,9 @@ dependencies:
   - mock
   - pillow
   - pip
-  - sphinx
-  - sphinx_rtd_theme=1.2
-  - sphinx-notfound-page
+  - sphinx=7.2.6
+  - sphinx-notfound-page=1.0.0
+  - sphinx-rtd-theme=2.0.0
 
   - pip:
     - pyramid

envs/environment-test.yaml

@@ -21,9 +21,9 @@ dependencies:
   - tomli
 
   # For documentation links checking
-  - sphinx
-  - sphinx_rtd_theme=1.2
-  - sphinx-notfound-page
+  - sphinx=7.2.6
+  - sphinx-notfound-page=1.0.0
+  - sphinx-rtd-theme=2.0.0
 
   - pip:
     - arrow

envs/requirements.txt

@@ -59,7 +59,7 @@ six==1.16.0
 snowballstemmer==2.2.0
 Sphinx==7.2.6
 sphinx-notfound-page==1.0.0
-sphinx-rtd-theme==1.2.2
+sphinx-rtd-theme==2.0.0
 sphinxcontrib-applehelp==1.0.7
 sphinxcontrib-devhelp==1.0.5
 sphinxcontrib-htmlhelp==2.0.4