python - 如何使用 Intersphinx 引用特定文档中的类？

Question

我已经设置了 Intersphinx -Python 2 和 Python 3 文档的映射:

intersphinx_mapping = {'py2': ('http://docs.python.org/', None),
                       'py3': ('http://docs.python.org/3', None)}

如何从这两个资源中的特定资源引用类？该文档仅提到:ref:erences，这两种尝试不起作用:

:ref:`collections.Mapping <py2:collections.Mapping>`
:class:`py3:collections.Mapping`

虽然这会生成预期的链接:

:class:`collections.Mapping`

Answer 1

下面的标记会生成与您的 intersphinx_mapping 配置的工作链接(对于 py2，我建议将 URL 更改为 http://docs.python.org/2 使版本明确)。

Python 2:

:class:`py2:collections.Mapping`

Python 3(Mapping 已移至 Python 3.3 中的 collections.abc):

:class:`py3:collections.abc.Mapping`