sphinx,django:使用sphinx.ext.intersphinx链接到Django文档

时间:2015-11-24 16:43:22

标签: python django python-sphinx

我想使用sphinx.ext.intersphinx添加对django文档的引用。我试过这个:

conf.py

....
extensions = [
    'sphinx.ext.intersphinx',
    ]

intersphinx_mapping = {
    'django': ('https://docs.djangoproject.com/en/1.9/', None),
    'python': ('https://docs.python.org/3.5', None),
    }

我的文档:

:ref:`Model Documentation <django:django-documentation>`
:ref:`Model Documentation <python:comparisons>`

Python的工作非常完美,但是Django并没有。

想知道是否有人实现了这一目标。在不使用网址的情况下链接到Django文档的更好方法是什么?

1 个答案:

答案 0 :(得分:0)

我终于找到了解决我问题的django ticket

# conf.py
intersphinx_mapping = {
   'django': ('http://docs.djangoproject.com/en/1.9/',
              'http://docs.djangoproject.com/en/1.9/_objects/'),
    }

然而,如果有人可以使用sphinx添加如​​何在不同文档中交叉引用标题,那将会很好。