Skip to content

sphinx-toolbox/seed_intersphinx_mapping

Repository files navigation

seed_intersphinx_mapping

Populate the Sphinx 'intersphinx_mapping' dictionary from the project's requirements.

Docs Documentation Build Status Docs Check Status
Tests Linux Test Status Windows Test Status macOS Test Status Coverage
PyPI PyPI - Package Version PyPI - Supported Python Versions PyPI - Supported Implementations PyPI - Wheel
Anaconda Conda - Package Version Conda - Platform
Activity GitHub last commit Maintenance PyPI - Downloads
QA CodeFactor Grade Flake8 Status mypy status
Other License GitHub top language Requirements Status

This avoids having to manually compile (and keep updated) a mapping like:

intersphinx_mapping = {
        "attrs": ("https://www.attrs.org/en/stable/", None),
        "Flask": ("https://flask.palletsprojects.com/en/1.1.x/", None),
        "matplotlib": ("https://matplotlib.org/stable/", None),
        "numpy": ("https://numpy.org/doc/stable/", None),
        "pandas": ("https://pandas.pydata.org/docs/", None),
        "Pyramid": ("https://docs.pylonsproject.org/projects/pyramid/en/latest/", None),
        "scikit-learn": ("https://scikit-learn.org/stable/", None),
        "scipy": ("https://docs.scipy.org/doc/scipy/reference/", None),
        "Sphinx": ("https://www.sphinx-doc.org/en/stable/", None),
        }
# Source: https://gist.github.com/bskinn/0e164963428d4b51017cebdb6cda5209

See the documentation for more information.

Note: Not all projects include a link to their documentation in the Project-URL field of Python's core metadata. Why not submit a pull request to them to include it?

Installation

seed_intersphinx_mapping can be installed from PyPI or Anaconda.

To install with pip:

$ python -m pip install seed_intersphinx_mapping

To install with conda:

  • First add the required channels
$ conda config --add channels https://conda.anaconda.org/conda-forge
$ conda config --add channels https://conda.anaconda.org/domdfcoding
  • Then install
$ conda install seed_intersphinx_mapping

Enable seed_intersphinx_mapping by adding "seed_intersphinx_mapping" to the extensions variable in conf.py:

extensions = [
    ...
    "seed_intersphinx_mapping",
    ]

For more information see https://www.sphinx-doc.org/en/master/usage/extensions/index.html#third-party-extensions .

See the documentation for more information on configuring seed_intersphinx_mapping.