parsowanie rST do HTML w locie za pomocą Docutils

Question

Chcę parsować pliki .rst do plików .html w locie, aby wyświetlić je jako stronę internetową. Używam piramidy i nie znalazłem żadnej szybkiej pomocy, jak używać docutils w kodzie Pythona i sprawić, by zapisywał się do bufora.

Ktoś ma jakieś linki do prostego samouczka lub jakiekolwiek inne sugestie, jak to zrobić?

Answer 1

Jednym ze sposobów jest zrobić coś takiego:

>>> 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'