Intersphinx甚至可以在intersphinx中使用python 3链接到python 2文档

我正在用狮身人面像(Sphinx == 1.7.0)使用intersphinx扩展名构建文档。 我注意到它默认链接到python 2文档,但我更喜欢链接到python 3文档,所以我将intersphinx_mapping中的intersphinx_mapping改为以下内容:

# conf.py
...
intersphinx_mapping = {
    'python': ('https://docs.python.org/3/': None),
}
...

但是,当我在我的源文件中引用python对象时,我发现它们仍然默认连接到python 2.如果我在前缀str前面以便它读取python:str (如文档中所述),我可以修复此问题,明确指出要使用哪个intersphinx映射。 例如:

# index.rst
:any:`str`         # surprisingly, this links to https://docs.python.org/2/library/functions.html#str
:any:`python:str`  # as expected, this links to https://docs.python.org/3/library/stdtypes.html#str

作为参考,这是文档说的:

当使用“新”格式(见下文)时,您甚至可以通过在链接目标前加适当的前缀来强制在外部集合中查找。 链接如:ref: comparison manual <python:comparisons>将链接到文档集“python”中的标签“比较”(如果存在)。

我的问题是:我怎样才能使默认的,非限定的intersphinx链接指向python 3文档而不是python 2文档?

链接地址: http://www.djcxy.com/p/75503.html

上一篇: Intersphinx links to python 2 docs even with python 3 in intersphinx

下一篇: Include my markdown README into Sphinx