如何在 reStructuredText 的内联文字中包含超链接引用？

Question

我正在使用带有 reStructuredText 的 Sphinx，并且我想在内联文字中包含一个超链接。但是，可以预见的是，如果我写

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。