python - readdoc - Parsing reStructuredText en HTML

rst file

Question

Estoy creando un marco en el que permito a los desarrolladores describir su paquete utilizando reStructuredText. Quiero analizar ese texto reStructured en HTML para poder mostrarlo en una GUI.

Estoy familiarizado con la excelente Esfinge, pero nunca he analizado el texto edStructured. Imaginé algo como una función que toma una cadena de texto reStructured, y posiblemente varios argumentos adicionales, y devuelve una cadena de HTML.

Así que miré Docutils, que es responsable de analizar el texto estructurado. No pude entender en absoluto cómo encontrar esta función. La documentación en la web es irregular. Muchas de las funciones en el módulo docutils.parsers.rst parecían estar orientadas a los nombres de archivos. ¡No tengo nombres de archivo! Solo estoy manejando cuerdas.

Intenté crear un Parser y un Document y usar el método de parse , pero acabo de recibir un error sobre la configuración de .tab_width faltante.

¿Alguien sabe cómo analizar reStructuredText en HTML?

Answer 1

Intenta algo como esto:

>>> from docutils.core import publish_string
>>> publish_string("*anurag*", writer_name=''html'')

publish_string acepta cadenas y genera una cadena o puede usar publish_parts para obtener partes específicas del documento html, por ejemplo

>>> from docutils.core import publish_parts
>>> print publish_parts("*anurag*", writer_name=''html'')[''html_body'']
<p><em>anurag</em></p>