[Documentation] Make code examples clickable, and update intersphinx …

…urls

Signed-off-by: Alexis Jeandet <alexis.jeandet@member.fsf.org>

.github/workflows/PRs.yml

@@ -36,7 +36,7 @@ jobs:
       run: sudo apt update && sudo apt install -y texlive pandoc && pip install wheel
     - name: Test with pytest
       run: |
-        pip install pytest pytest-cov sphinx numpydoc sphinx-rtd-theme sphinx_gallery nbsphinx pandoc
+        pip install pytest pytest-cov sphinx numpydoc sphinx-rtd-theme sphinx_gallery nbsphinx pandoc sphinx-codeautolink
         pytest --cov=./ --cov-report=xml
         make doctest
     - name: Upload coverage to Codecov

.github/workflows/tests.yml

@@ -36,7 +36,7 @@ jobs:
       run: sudo apt update && sudo apt install -y texlive pandoc && pip install wheel
     - name: Test with pytest
       run: |
-        pip install pytest pytest-cov sphinx numpydoc sphinx-rtd-theme sphinx_gallery nbsphinx pandoc
+        pip install pytest pytest-cov sphinx numpydoc sphinx-rtd-theme sphinx_gallery nbsphinx pandoc sphinx-codeautolink
         pytest --cov=./ --cov-report=xml
         make doctest
     - name: Upload coverage to Codecov

docs/conf.py

@@ -38,10 +38,14 @@
     'sphinx.ext.viewcode',
     'sphinx.ext.doctest',
     'sphinx.ext.intersphinx',
+    'sphinx.ext.autosectionlabel',
     'sphinx_gallery.load_style',
+    'sphinx_codeautolink',
     'nbsphinx',
     'numpydoc']
 
+autosectionlabel_prefix_document = True
+
 nbsphinx_execute_arguments = [
     "--InlineBackend.figure_formats={'svg', 'pdf'}",
     "--InlineBackend.rc=figure.dpi=96",
@@ -203,9 +207,10 @@
 ]
 
 
-intersphinx_mapping = {'python3': ('http://docs.python.org/3', None),
-                       'numpy': ('http://docs.scipy.org/doc/numpy/', None),
-                       'scipy': ('http://docs.scipy.org/doc/scipy/reference/', None),
-                       'matplotlib': ('http://matplotlib.sourceforge.net/', None),
-                       'astropy': ('http://astropy.readthedocs.org/en/stable/', None),
+intersphinx_mapping = {'python3': ('https://docs.python.org/3', None),
+                       'numpy': ('https://numpy.org/doc/stable/', None),
+                       'scipy': ('https://docs.scipy.org/doc/scipy/reference/', None),
+                       'matplotlib': ('https://matplotlib.org/stable/', None),
+                       'seaborn': ('https://seaborn.pydata.org/', None),
+                       'astropy': ('https://docs.astropy.org/en/stable/', None),
                        }

docs/requirements.txt

@@ -5,3 +5,4 @@ sphinx-gallery
 nbsphinx
 ipympl
 ipywidgets
+sphinx-codeautolink