Как я могу сослаться на класс из конкретной документации Intersphinx?

Я настроил 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`

python documentation python-sphinx cross-reference
person funky-future    schedule 27.09.2015    source источник

Ответы (1)


arrow_upward
3
arrow_downward

Приведенная ниже разметка создает рабочие ссылки с вашей конфигурацией intersphinx_mapping (для py2 я предлагаю изменить URL-адрес на http://docs.python.org/2, чтобы сделать версию явной).

Питон 2:

:class:`py2:collections.Mapping`

Python 3 (Mapping был перемещен в collections.abc в Python 3.3):

:class:`py3:collections.abc.Mapping`
person mzjn    schedule 28.09.2015