Как я могу включить ссылку на гиперссылку внутри встроенного литерала в reStructuredText?

Question

Я использую Sphinx с reStructuredText, и я хотел бы включить гиперссылку во встроенный литерал.Однако, как и ожидалось, если я напишу

The result has type ``Foo_ -> Bar_``.

.. _Foo:

Information about ``Foo``.

.. _Bar:

Information about ``Bar``.

, то Foo_ и Bar_ не будут превращены в гиперссылки.Если я изменю свой документ на использование блока parsed-literal вместо

The result has type:

.. parsed-literal::

    Foo_ -> Bar_

, я получу нужные мне гиперссылки.Однако я не хочу отдельный блок - я хочу, чтобы код был встроенным.Есть ли способ сделать это?

Answer 1

Вы можете довольно близко подойти к заменам.

.. |Foo| replace:: ``Foo``
.. |Bar| replace:: ``Bar`` 

The result has type |Foo|_ ``->`` |Bar|_.

.. _Foo:

Information about ``Foo``.

.. _Bar:

Information about ``Bar``.

Это было вдохновлено обходным решением для вложенной встроенной разметки, описанным здесь: http://docutils.sourceforge.net/FAQ.html#is-nested-inline-markup-possible.

См. Также Формат текста вссылка в reStructuredText .