在reStructuredText中,如何将内联文字放在超链接中？

Question

在我的reStructuredText文档中,我有一个像这样定义的部分:

Update the ``PATH`` Environment Variable
----------------------------------------

我想像这样链接到这一部分:

* `Update the ``PATH`` Environment Variable`_

但是,当此代码呈现为HTML时,它看起来像这样:

• 更新``PATH`环境变量`

我真的很喜欢环境变量PATH以字面样式出现,但我对此很新.谁能帮我吗？

Answer 1

有了解决方法，是的——这是可能的（@mzjn 的评论暗示）。

例如：

.. |dummy| replace:: Update the ``PATH`` Environment Variable
.. _dummy:

Update the ``PATH`` Environment Variable
----------------------------------------

* |dummy|_

这是通过利用替换指令来实现的。

Answer 2

摘自Sphinx 文档：

如果将标签直接放置在节标题之前，则可以使用 引用它:ref:`label-name`。

例子：

.. _my-reference-label:

Section to cross-reference
--------------------------

This is the text of the section.

It refers to the section itself, see :ref:`my-reference-label`.