Cómo convertir reStructuredText a texto sin formato

Question

Planeo usar reStructuredText para escribir documentación con el propósito principal de generar algunas páginas HTML agradables. Para esto uso la herramienta docutils rst2html.py.

Sin embargo, también es posible que deba presentar la documentación en un formato de texto plano, sin el reStructuredText, y donde el ajuste de párrafo y el formato agradable similar aún se realiza en el texto. Pero no hay una herramienta rst2txt.py en los docutils.

¿Hay alguna manera de convertir reStructuredText al formato de texto plano, quizás con el uso de opciones especiales para docutils?

Answer 1

Sphinx tiene un TextBuilder para formato de salida de texto. Lo intenté y parece hacer lo que está buscando.

Sin embargo, podría estar un poco desactualizado porque no está en el Makefile predeterminado. Pero funcionó bien en mi documentación bastante compleja (150 páginas en PDF). Para usarlo, basta con añadir el siguiente objetivo a ella:

text: 
    $(SPHINXBUILD) -b text $(ALLSPHINXOPTS) _build/text 
    @echo 
    @echo "Build finished." 

Además, tenga en cuenta que Sphinx implementa sólo un subconjunto de las primeras especificaciones.

Answer 2

También he visto este hecho por la representación de HTML usando rst2html, a continuación, convertir el HTML a texto sin formato mediante el uso de un navegador HTML de línea de comandos, tales como:

• lince http://lynx.browser.org
• enlaces http://links.sourceforge.net
• w3m http://w3m.sourceforge.net
• Resultados de enlaces http://elinks.or.cz

Cada uno de estos navegadores tiene un modificador de línea de comandos o similares para hacer su salida a un archivo .txt, por lo que podría crear un guión de dos líneas llamada 'rst2txt', algo así como:

rst2html docs.rst docs.html 
lynx -dump docs.html > docs.txt 

Answer 3

El texto en línea NoTex.ch editor (con soporte para rST) incluye soporte para conversión de texto sin formato (que está basado en Sphinx 'TextBuilder).