Жирный курсив в ReStructuredText

Я пишу некоторую документацию, используя формат ReStructuredText (ReST) для более поздней генерации веб-страницы с использованием Sphinx, и я не могу найти способ написать текст "жирным курсивом".

Существуют маркеры для так называемого текста "выделение" (курсив) и "сильный акцент" (жирный). Они *italic text* и **bold text** соответственно. Я также читал в некоторых документах в этом формате, что эти маркеры форматирования не могут быть просто "вложенными". То есть ***text*** (или ** *text* **) не создает текст полужирный курсив.

Тем не менее, вероятно, должен быть какой-то способ создать текст, подчеркнутый как полужирным, так и курсивом, поскольку широко распространена практика отмечать фрагменты текста таким образом.

Ответы

Ответ 1

Хотя Markdown поддерживает вложенный жирный и курсив, reStructuredText не делает этого (это один из редких случаев, когда Markdown более мощный, поскольку нет способа отобразить жирный курсив в reStructuredText).

https://gist.github.com/1855764

Ответ 2

Рецепт для вывода HTML.

my.rst:

.. role:: red
  :class: red

.. role:: bolditalic
  :class: bolditalic

:red:'WARNING' :bolditalic:'Don't be stupid!'

my.css:

.red { color: red; }
.bolditalic {
  font-weight: bold;
  font-style: italic;
}

Построить по:

rst2html --strip-comments --halt warning --stylesheet=my.css my.rst my.html

Ответ 3

В сфинксе это возможно с помощью пользовательских ролей: вы создаете стиль в css и создаете роль, указывающую на этот стиль. Вот полный рабочий пример подчеркнутого текста: sphinx-dev thread.

Редактировать:

Вот хороший пример: ReST зачеркнутый

Изменить 2:

Эта ссылка sphinx-dev больше не доступна, так что здесь суть, она очень похожа на ссылку зачеркивания выше:

CSS:

span.underlined {
  text-decoration: underline;
}

Регистрация роли в РСТ:

.. role:: underlined
   :class: underlined

использовать его позже как

:underlined:'test'

Все это может быть в одном документе RST:

.. raw:: html

   <style type="text/css">
     span.underlined {
       text-decoration: underline;
     }
   </style>

.. role:: underlined
   :class: underlined

:underlined:'test'

Проверьте это с ::

rst2html5.py test01.rst test01.html