В Sphinx, если у меня есть следующее объявление заголовка:
.. _somestuff:
``this is code``, this is not!
==============================
Он отображает, например:
this is code, это не!Это хорошо, но если я использую ссылку, например:
Have a look at :ref:`somestuff`
Он теряет форматирование кода и отображает:
Посмотрите это код, это не!
вместо:
Посмотрите this is code, это не так!
Можно ли сохранить форматирование кода в ссылке? И как бы я это сделал?
Если вы посмотрите документацию :ref: на официальном веб-сайте о встроенных разметках:
: ссылка:
Чтобы поддерживать перекрестные ссылки на произвольные местоположения в любом документе, используются стандартные метки reST. Для этого для работы с именами ярлыков необходимо быть уникальным во всей документации...
Я думаю (как @Kevin Horn), это невозможно сейчас, потому что он использовался только для создания ссылок (без первого форматирования) с другими разделами в вашем проекте. Тогда, если вы напишете что-то вроде этого:
.. _somestuff:
``this is code``, this is not!
==============================
.. _another_somestuff:
this is another code!
========================
Если я связываюсь с этими разделами:
Have a look at :ref:`somestuff`
Have a look at :ref:`another_somestuff`
Have a look at :ref:`this link <somestuff>`
Результат:
Взгляните на , это код, это не так!
Взгляните на , это еще один код!
Посмотрите эту ссылку
Стиль одинаковый во всех из них.
Примечание: курсивные/жирные слова символизируют ссылки