[doc] Switch to auto-intersphinx

doc/catalog.json

+{
+    "numpy": {
+        "version": {
+            "latest": "https://numpy.org/doc/stable/"
+        },
+        "sources": {
+            "readthedocs": "numpy"
+        }
+    },
+    "matplotlib": {
+        "version": {
+            "latest": "https://matplotlib.org/stable/"
+        },
+        "sources": {
+            "readthedocs": "matplotlib"
+        }
+    },
+    "PIL": {
+        "version": {
+            "latest": "https://pillow.readthedocs.io/en/latest/"
+        },
+        "sources": {
+            "readthedocs": "pillow"
+        }
+    }
+}

doc/conf.py

@@ -106,10 +106,10 @@ autodoc_default_options = {
     "show-inheritance": True,
 }
 
-intersphinx_mapping = {
-    "python": ("https://docs.python.org/3", None),
-    "scipy": ("https://docs.scipy.org/doc/scipy/", None),
-    "numpy": ("https://numpy.org/doc/stable/", None),
-    "matplotlib": ("https://matplotlib.org/stable/", None),
-    "PIL": ("https://pillow.readthedocs.io/en/latest/", None),
-}
+auto_intersphinx_packages = [
+    ("python", "3"),
+    "numpy",
+    "matplotlib",
+    "PIL",
+]
+auto_intersphinx_catalog = "catalog.json"

pyproject.toml

@@ -30,7 +30,7 @@ dependencies = [
 ]
 
 [project.urls]
-documentation = "https://www.idiap.ch/software/bob/docs/bob/bob.io.base/master/"
+documentation = "https://www.idiap.ch/software/bob/docs/bob/bob.io.base/master/sphinx"
 homepage = "https://pypi.org/project/bob.io.base"
 repository = "https://gitlab.idiap.ch/bob/bob.io.base"
 changelog = "https://gitlab.idiap.ch/bob/bob.io.base/-/releases"
@@ -40,6 +40,7 @@ qa = ["pre-commit"]
 doc = [
     "sphinx",
     "sphinx_rtd_theme",
+    "auto-intersphinx",
     ]
 test = [
     "pytest",