Превратите поля в reStructuredText в html

Итак, у меня есть документ 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...


person lost    schedule 08.03.2013    source источник


Ответы (1)


взгляните на это и дайте мне знать, если это поможет вам

ReStructuredText (reST)

person PurityLake    schedule 08.03.2013
comment
Ну, это минимальный пример наследования от HTMLTranslator, который был бы в порядке, если бы мне пришлось пойти по этому пути, но выполнение этого и настройка методов visit_field по-прежнему кажутся слишком сложными, учитывая, что поля перечислены как механизм расширения в документах docutils. - person lost; 08.03.2013
comment
извините, что я не смог придумать больше, похоже, что reST сильно недокументирован - person PurityLake; 08.03.2013