Другой ответ здесь намекает на то, что я хотел сделать, но он предполагает некоторые подробные знания о таблицах стилей в документах.Вот объяснение кулинарной книги:
В вашем RST-файле объявите роль один раз, затем используйте ее:
.. role:: red
This text is :red:`colored red` and so is :red:`this`
Затем вам нужен файл таблицы стилей.Сначала используйте Python, чтобы скопировать таблицу стилей по умолчанию из пакета documentstils:
python
import os.path
import shutil
import docutils.writers.html4css1 as h
shutil.copy(os.path.dirname(h.__file__)+"/html4css1.css","my.css")
Затем отредактируйте my.css, добавив в конце ваши настройки:
.red {
color: red;
}
Создайте документированиефайл конфигурации с именем «documentstils.conf»:
[html4css1 writer]
stylesheet-path: my.css
embed-stylesheet: yes
используйте rst2html.py для преобразования вашего документа:
rst2html.py my_document.rst > my_document.html
Если вы не хотите использовать documenttils.conf, вы можетеуказывайте таблицу стилей каждый раз, когда вы запускаете rst2html:
rst2html.py --stylesheet my.css my_document.rst > my_document.html
AFAIK, невозможно указать таблицу стилей в файле RST.