如何使用Intersphinx從特定文檔中引用類？

Question

我已成立了一個Intersphinx -mapping爲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`