Как сделать внутреннюю гиперссылку в документации sphinx

Question

Как сделать внутреннюю гиперссылку в документации sphinx? Я использую:

:role:`target`  

Но это не работает.

Answer 1

Перекрестные ссылки выполняются с использованием ref

:ref:`label-name`

Вы можете предоставить свои метки, используя:

.. _label-name:

См .: http://sphinx.pocoo.org/markup/inline.html#ref-role

Ролииспользуются для создания пользовательского интерпретируемого текста.Смотри: http://docutils.sourceforge.net/docs/ref/rst/directives.html#role