From e4048c79826d3ae314d2b2461330e0a00aff9f4d Mon Sep 17 00:00:00 2001
From: M Bussonnier <bussonniermatthias@gmail.com>
Date: Mon, 27 May 2024 15:27:36 +0200
Subject: [PATCH] use intersphinx_registry

---
 docs/source/conf.py | 31 +++++++++++++++++++++++++++----
 1 file changed, 27 insertions(+), 4 deletions(-)

diff --git a/docs/source/conf.py b/docs/source/conf.py
index 0f22e547bc..c37a01fb13 100755
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -92,12 +92,35 @@
 
 locals().update(config["sphinx"])
 
-intersphinx_mapping = config["intersphinx_mapping"]
-for k, v in intersphinx_mapping.items():
-    intersphinx_mapping[k] = tuple(
-        [intersphinx_mapping[k]["url"], intersphinx_mapping[k]["fallback"]]
+try:
+    from intersphinx_registry import get_intersphinx_mapping
+
+    intersphinx_mapping = get_intersphinx_mapping(
+        packages={
+            "python",
+            "rpy2",
+            "jupyterclient",
+            "jupyter",
+            "jedi",
+            "traitlets",
+            "ipykernel",
+            "prompt_toolkit",
+            "ipywidgets",
+            "ipyparallel",
+            "pip",
+        }
     )
 
+except ModuleNotFoundError:
+    # In case intersphinx_registry is not yet packages on current plaform
+    # as it is quite recent.
+    intersphinx_mapping = config["intersphinx_mapping"]
+    for k, v in intersphinx_mapping.items():
+        intersphinx_mapping[k] = tuple(
+            [intersphinx_mapping[k]["url"], intersphinx_mapping[k]["fallback"]]
+        )
+
+
 # numpydoc config
 numpydoc_show_class_members = config["numpydoc"][
     "numpydoc_show_class_members"