Встроенную подсветку кода в настройки

Я знаю, что reStructuredText имеет эту директиву:

.. code:: bash

    gedit pohl.m

который отображает блок кода. Есть ли способ получить подсветку синтаксиса для встроенных фрагментов типа этого:

Do edit the file, type ``gedit pohl.m`` into a terminal.

обратные палочки отмечают его как код, но я хотел бы выделить его с пигментами, такими как блок. Это возможно?

1 100
restructuredtext

1 ответ:

заглянув в это еще немного я наткнулся на документ настройки интерпретировать текст роли. Из этого документа:

интерпретированный текст использует обратные кавычки ( ` ) вокруг текста. Явный маркер роли может дополнительно отображаться до или после текста, разделенного двоеточиями. Например:

This is `interpreted text` using the default role.

This is :title:`interpreted text` using an explicit role.

кажется, что есть code роль, так что вы можете просто ввести

:code:`a = b + c`

принять встроенный блок кода. Чтобы получить подсветку синтаксиса, можно определить пользовательскую роль. Например

.. role:: bash(code)
   :language: bash

который затем можно использовать так:

Here is some awesome bash code :bash:`a = b + c`.

обратите внимание, что определение роли должно быть помещено перед ссылками на роль.

обратите внимание, что в документе, на который я ссылаюсь, не упоминается версия docutils, на которую он ссылается. Роль кода не доступно в docutils 0.8.1 (это единственная версия, которую я должен протестировать).

169