После документации для установки ссылок на документацию Сфинкса между пакетами добавил я
intersphinx_mapping = {'python': ('http://docs.python.org/2', None),
'numpy': ('http://docs.scipy.org/doc/numpy/', None),
'scipy': ('http://docs.scipy.org/doc/scipy/reference/', None),
'matplotlib': ('http://matplotlib.sourceforge.net/', None)}
к моему conf.py
, но, может казаться, не заставляет ссылки ни на какой проект кроме самого Python работать. Например,
:term:`svg graphics <matplotlib:svg>`
просто берет меня к индексной странице, не добавляя ожидаемый #term-svg
привязка, и я не могу даже определить местоположение глоссария для scipy
или фигура, как определить что :ref:
s или :term:
s поддерживаются пакетом.
Где я могу найти инструкции относительно того, как указать цели для :ref:
s и :term:
s в numpy
, scipy
, и matplotlib
?
В этом отношении, как я связываюсь с самим Сфинксом? Добавление
intersphinx_mapping['sphinx'] = ('http://sphinx-doc.org/', None)
и
:ref:`Intersphinx <intersphinx>`
не работает.
Дополнительный способ знать, как сделать перекрестную ссылку, с модуль sphobjinv .
можно искать локальные или даже удаленные файлы материально-технических ресурсов (с нечетким соответствием). Например, с scipy:
$ sphobjinv suggest -t 90 -u https://docs.scipy.org/doc/scipy/reference/objects.inv "signal.convolve2d"
Remote inventory found.
:py:function:`scipy.signal.convolve2d`
:std:doc:`generated/scipy.signal.convolve2d`
Примечание, которое Вы, возможно, должны использовать :py:func:
а не :py:function:
(я был бы рад знать почему).