如何在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中所述的嵌套内联标记的解决方法的启发。

另请参阅Format text in a link in reStructuredText。