如何使用 Intersphinx 从特定文档中引用一个类？答案

【问题标题】：How can I reference a class from a specific documentation with Intersphinx?如何使用 Intersphinx 从特定文档中引用一个类？
【发布时间】：2015-09-27 20:06:50
【问题描述】：

我已经为 Python 2 和 Python 3 的文档设置了一个Intersphinx-mapping：

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`

【问题讨论】：

标签： python documentation python-sphinx cross-reference

【解决方案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`

【讨论】：