如何使用 Intersphinx 从特定文档中引用 class？

Question

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

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

如何从这两个资源中的特定资源中引用 class？文档只提到了 :ref:erences 并且这两个尝试不起作用：

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

虽然这会生成预期的 link:

: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`

How can I reference a class from a specific documentation with Intersphinx?