Итак, у меня есть документ reStructuredText, который включает поля:
:param foo: set this to do magic
и я хочу превратить rST в html со специальной обработкой полей param
(и других).
Превратить rST в html можно с помощью docutils.core.publish_parts
, как предложено здесь, но очевидно, без контроля над выводом полей. Или я могу использовать docutils.core.publish_doctree
, как предложено здесь, чтобы получить псевдо-XML и, предположительно, ( довольно утомительно) измените это, но я не понимаю, как я могу контролировать, как это переводится в html.
Я вижу, что в docutils.writers.html4css1.__init__.py
есть класс HTMLTranslator
, но я, конечно, не могу изменить его только для управления выводом полей? Я надеюсь, что где-то есть какая-то система шаблонов, которая контролирует, как XML переводится в html...