DOC: enable the sphinx_codeautolink extension (+ intersphinx)

doc/allow-errors.ipynb

@@ -62,24 +62,6 @@
     "42 / 0"
    ]
   },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "print 'Hello, world!'"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "6 ~ 7"
-   ]
-  },
   {
    "cell_type": "code",
    "execution_count": null,
@@ -106,12 +88,12 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.6.7"
+   "version": "3.9.7"
   },
   "nbsphinx": {
    "allow_errors": true
   }
  },
  "nbformat": 4,
- "nbformat_minor": 2
+ "nbformat_minor": 4
 }

doc/conf.py

@@ -10,8 +10,19 @@
     'sphinxcontrib.rsvgconverter',  # for SVG->PDF conversion in LaTeX output
     'sphinx_gallery.load_style',  # load CSS for gallery (needs SG >= 0.6)
     'sphinx_last_updated_by_git',  # get "last updated" from Git
+    'sphinx_codeautolink',  # automatic links from code to documentation
+    'sphinx.ext.intersphinx',  # links to other Sphinx projects (e.g. NumPy)
 ]
 
+# These projects are also used for the sphinx_codeautolink extension:
+intersphinx_mapping = {
+    'IPython': ('https://ipython.readthedocs.io/en/stable/', None),
+    'matplotlib': ('https://matplotlib.org/', None),
+    'numpy': ('https://docs.scipy.org/doc/numpy/', None),
+    'pandas': ('https://pandas.pydata.org/docs/', None),
+    'python': ('https://docs.python.org/3/', None),
+}
+
 # Don't add .txt suffix to source files:
 html_sourcelink_suffix = ''
 

doc/requirements.txt

@@ -8,3 +8,4 @@ ipywidgets
 sphinx-gallery
 jupytext
 sphinx-last-updated-by-git
+sphinx-codeautolink