From c93c4014b9619475eaee4f84223fd25da6f6b148 Mon Sep 17 00:00:00 2001 From: Christian Diener Date: Tue, 20 May 2025 15:32:14 +0200 Subject: [PATCH] bump sphinx versions, some fixes, new theme --- documentation_builder/conf.py | 10 ++++++---- documentation_builder/requirements.txt | 6 +++--- 2 files changed, 9 insertions(+), 7 deletions(-) diff --git a/documentation_builder/conf.py b/documentation_builder/conf.py index 6d0384206..088e43621 100644 --- a/documentation_builder/conf.py +++ b/documentation_builder/conf.py @@ -29,11 +29,11 @@ "sphinx.ext.autodoc", "sphinx.ext.intersphinx", "sphinx.ext.mathjax", - "sphinx.ext.viewcode", "sphinx.ext.napoleon", "sphinx.ext.autosummary", "autoapi.extension", "nbsphinx", + "sphinx.ext.viewcode", ] # Document Python Code autoapi_dirs = [join(SRC_PATH, "cobra")] @@ -123,8 +123,10 @@ # Example configuration for intersphinx: refer to the Python standard library. intersphinx_mapping = { - "http://docs.python.org/": None, - "http://docs.scipy.org/doc/numpy/": None, - "http://docs.scipy.org/doc/scipy/reference": None, + "python": ("http://docs.python.org/", None), + "numpy": ("http://docs.scipy.org/doc/numpy/", None), + "scipy": ("http://docs.scipy.org/doc/scipy/reference", None), } intersphinx_cache_limit = 10 # days to keep the cached inventories + +html_theme = "sphinx_book_theme" diff --git a/documentation_builder/requirements.txt b/documentation_builder/requirements.txt index 51ee40a3c..fd035c9b8 100644 --- a/documentation_builder/requirements.txt +++ b/documentation_builder/requirements.txt @@ -1,6 +1,6 @@ -Sphinx~=5.3 +Sphinx>=8.2 sphinxcontrib-napoleon -sphinx-autoapi +sphinx-autoapi>=3.6 nbsphinx>=0.2.4 +sphinx-book-theme~=1.1 ipykernel -matplotlib>=3.6