В reStructuredText, как установить встроенный литерал внутри гиперссылки?

В моем документе reStructuredText у меня есть раздел, определенный так:

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

Я хотел бы сделать ссылку на этот раздел следующим образом:

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

Но, когда этот код отображается в HTML, он выглядит следующим образом:

  • Обновить переменную среды `` PATH`

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

Ответ 1

С обходным решением да - это возможно (намекнул комментарий @mzjn).

Например:

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

Update the ''PATH'' Environment Variable
----------------------------------------

* |dummy|_

Это достигается за счет использования директивы replace.

Ответ 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'.