Use intersphinx registry to avoid out of date links. (numpy#563)

* Use intersphinx registry to avoid out of date links.

* Update doc/conf.py

---------

Co-authored-by: Eric Larson <larson.eric.d@gmail.com>

doc/conf.py

@@ -12,6 +12,8 @@
 import sys
 from datetime import date
 
+from intersphinx_registry import get_intersphinx_mapping
+
 import numpydoc
 
 # for example.py
@@ -136,9 +138,6 @@
 
 # -- Intersphinx setup ----------------------------------------------------
 
-# Example configuration for intersphinx: refer to the Python standard library.
-intersphinx_mapping = {
- "python": ("https://docs.python.org/3/", None),
- "numpy": ("https://numpy.org/doc/stable/", None),
- "sklearn": ("https://scikit-learn.org/stable/", None),
-}
+# Example configuration for intersphinx: refer to several Python libraries.
+
+intersphinx_mapping = get_intersphinx_mapping(packages=["python", "numpy", "sklearn"])

pyproject.toml

@@ -53,6 +53,7 @@ doc = [
  'matplotlib>=3.5',
  'pydata-sphinx-theme>=0.13.3',
  'sphinx>=7',
+ 'intersphinx_registry',
 ]
 test = [
  'pytest',

requirements/doc.txt

@@ -4,3 +4,4 @@ numpy>=1.22
 matplotlib>=3.5
 pydata-sphinx-theme>=0.13.3
 sphinx>=7
+intersphinx_registry