Intersphinx¶
Intersphinx is a built-in Sphinx module that allows for mapping to other project’s documentation. An example would be that you want to specify that your function accepts a Django model as a parameter.
Setup¶
The file /docs/conf.py will have your sphinx configuration and will need the intersphinx_mappings directive configured. Ambition’s ambition-python-template and django-app-template both already have this set up. You will also need to make sure the library is in requirements/docs.txt.
intersphinx_mapping = {
'python': ('http://python.readthedocs.org/en/v2.7.2/', None),
'django': ('http://django.readthedocs.org/en/latest/', None),
'celery': ('http://celery.readthedocs.org/en/latest/', None),
}