Compatibility with Sphinx8

Author: davidfischer

docs/source/conf.py

@@ -75,7 +75,7 @@
 #
 # This is also used if you do content translation via gettext catalogs.
 # Usually you set "language" from the command line for these cases.
-language = None
+language = "en"
 
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
@@ -176,5 +176,14 @@
 
 # -- Options for intersphinx extension ---------------------------------------
 
-# Example configuration for intersphinx: refer to the Python standard library.
-intersphinx_mapping = {'https://docs.python.org/': None}
+intersphinx_cache_limit = 14  # cache for 2 weeks
+intersphinx_timeout = 3  # 3 seconds timeout
+
+# Refer to the Python standard library.
+intersphinx_mapping = {
+    "python": ("https://docs.python.org/3.10/", None),
+}
+
+# Intersphinx: Do not try to resolve unresolved labels that aren't explicitly prefixed.
+# https://www.sphinx-doc.org/en/master/usage/extensions/intersphinx.html#confval-intersphinx_disabled_reftypes
+intersphinx_disabled_reftypes = ["*"]

requirements.txt

@@ -2,5 +2,5 @@
 git+https://github.com/davidfischer/python-abp
 
 # Needed to build the docs
-Sphinx
+Sphinx >= 8.0, <9
 sphinx_rtd_theme