синтаксический анализ rST на HTML на лету с использованием Docutils

Question

Я хочу анализировать файлы .rst в .html файлы «на лету» для отображения в виде веб-страницы. Я использую пирамиду, и я не нашел быстрой помощи в том, как использовать docutils внутри кода python и заставить его писать в буфер.

У кого-нибудь есть ссылки на простой учебник или любые другие предложения о том, как это сделать?

Answer 1

Один из способов сделать что-то вроде:

>>> a = """=====\nhello\n=====\n\n - one\n - two\n""" 
>>> import docutils 
>>> docutils.core.publish_parts(a, writer_name='html')['html_body'] 
u'<div class="document" id="hello">\n<h1 class="title">hello</h1>\n<blockquote>\n<ul class="simple">\n<li>one</li>\n<li>two</li>\n</ul>\n</blockquote>\n</div>\n'