Использование тегов <i>в reStructuredText - PullRequest
4 голосов
/ 12 июня 2019

Я знаю, что следующие теги работают для тегов <em>:

:emphasis:`lorum ipsum`
*lorum ipsum*

Как вместо этого можно генерировать теги <i>?Кажется, я не могу найти упоминания в спецификации разметки .

Ответы [ 2 ]

0 голосов
/ 25 июня 2019

Прежде чем мы начнем понимать, действительно ли вам нужны <i> метки?Люди часто используют <i>, когда они действительно имеют в виду <em> ... и они почти всегда выглядят одинаково по умолчанию ...

Нет?Вам действительно нужны <i> теги>?Хорошо, тогда мы идем.


Чтобы управлять тегами HTML, испускаемыми documenttils, вам необходимо создать нового "writer" .Это компоненты documenttils, которые генерируют выходные данные в любом желаемом формате (например, HTML, LateX и т. Д.).

Вы можете найти различные писатели HTML, включенные в Docutils в репозитории исходных документов Docutils здесь .

Это потребует написания кода на Python.В сущности, для этого потребуется предоставить класс Python, который будет генерировать нужный вам HTML.

Если коротко взглянуть на исходный код, вы, вероятно, можете создать подкласс того, кто лучше всего подойдет для писателя HTML (в наши дни вы, вероятно, захотите html5_polyglot) ипереопределите метод visit_emphasis.

Затем вам нужно будет найти способ сообщить документально использовать вашего нового писателя.Посмотрите каталог tools для некоторых примеров.

Если вы используете Sphinx, я действительно не уверен, как получить другого писателя.Возможно, вам придется изменить (или monkeypatch) исходный код Sphinx.

0 голосов
/ 24 июня 2019

Текст, заключенный в одну звездочку, выделяется:

Это выделенный текст .Подчеркнутый текст обычно отображается курсивом.

...