Merge pull request #1001 from gchq/fix/sphinx-8.2

Fix compatibility with sphinx 8.2.x

Author: bk958178

documentation/source/conf.py

@@ -105,7 +105,7 @@
 # pylint: disable=invalid-name
 bibtex_default_style = STYLE_NAME
 bibtex_references_path = SOURCE_FOLDER_PATH / "references.bib"
-bibtex_bibfiles = [str(bibtex_references_path)]
+bibtex_bibfiles = [bibtex_references_path.relative_to(SOURCE_FOLDER_PATH).as_posix()]
 # pylint: enable=invalid-name
 
 

pyproject.toml

@@ -72,7 +72,7 @@ test = [
 # Compile documentation
 doc = [
     "furo>=2024",
-    "sphinx>=7, !=8.2.*",
+    "sphinx>=7",
     "sphinx-autodoc-typehints>=2",
     "sphinx-toolbox>=3",
     "sphinxcontrib-bibtex>=2",

requirements-doc.txt

@@ -40,7 +40,7 @@ jaxlib==0.4.30 ; python_full_version < '3.10'
 jaxlib==0.4.38 ; python_full_version >= '3.10'
 jaxopt==0.8.3
 jaxtyping==0.2.36 ; python_full_version < '3.10'
-jaxtyping==0.2.38 ; python_full_version >= '3.10'
+jaxtyping==0.3.0 ; python_full_version >= '3.10'
 jinja2==3.1.6
 joblib==1.4.2
 jsonschema==4.23.0
@@ -61,7 +61,7 @@ optax==0.2.4
 orbax-checkpoint==0.6.4 ; python_full_version < '3.10'
 orbax-checkpoint==0.11.5 ; python_full_version >= '3.10'
 packaging==24.2
-platformdirs==4.3.6
+platformdirs==4.3.7
 protobuf==6.30.1
 pybtex==0.24.0
 pybtex-docutils==1.0.3
@@ -70,21 +70,24 @@ pyyaml==6.0.2
 referencing==0.36.2
 requests==2.32.3
 rich==13.9.4
+roman-numerals-py==3.1.0 ; python_full_version >= '3.11'
 rpds-py==0.23.1
 ruamel-yaml==0.18.10
 ruamel-yaml-clib==0.2.12 ; python_full_version < '3.13' and platform_python_implementation == 'CPython'
 scikit-learn==1.6.1
 scipy==1.13.1 ; python_full_version < '3.10'
 scipy==1.15.2 ; python_full_version >= '3.10'
-setuptools==76.0.0 ; python_full_version >= '3.12'
+setuptools==77.0.1 ; python_full_version >= '3.12'
 simplejson==3.20.1 ; python_full_version >= '3.10'
 six==1.17.0
 snowballstemmer==2.2.0
 soupsieve==2.6
 sphinx==7.4.7 ; python_full_version < '3.10'
-sphinx==8.1.3 ; python_full_version >= '3.10'
+sphinx==8.1.3 ; python_full_version == '3.10.*'
+sphinx==8.2.3 ; python_full_version >= '3.11'
 sphinx-autodoc-typehints==2.3.0 ; python_full_version < '3.10'
-sphinx-autodoc-typehints==3.0.1 ; python_full_version >= '3.10'
+sphinx-autodoc-typehints==3.0.1 ; python_full_version == '3.10.*'
+sphinx-autodoc-typehints==3.1.0 ; python_full_version >= '3.11'
 sphinx-basic-ng==1.0.0b2
 sphinx-jinja2-compat==0.3.0
 sphinx-prompt==1.8.0 ; python_full_version < '3.10'