Entradas

Trabajar con reStructuredText: Docutils y rst2pdf

Hace unos años, era habitual al realizar trabajos, escribir cartas, o documentos, utilizar MS Office un procesador de textos. En la actualidad, nos encontramos que la información se presenta en la mayoria de los casos en formato PDF, o incluso directamente documentos web en HTML.

Desde hace poco, vengo utilizando una herramienta que de forma sencilla, puedes obtener un documento en PDF/HTML de un simple documento de texto (.txt) siguiendo unas simples pautas con la información.
Este modo de estructurar la información se llama reStructuredText.

¿Qué es?

reStructuredText es un lenguaje de marcas ligero, de fácil lectura en su formato de fuente pero muy versátil para producir documentos complejos.

¿Qué puedo hacer?

  • Escribo la documentación en texto plano y después la convierto a distintos formatos.
  • Soporta versionado porque es texto.
  • Se puede leer con cualquier editor.
Los documentos se puede convertir a muchos formatos diferentes, a destacar: PDF y HTML
Además, permite utilizar hojas de estilos predeterminadas para incluir en la conversión, lo cual hace que puedas crear un documento PDF o HTML “curioso” con unos sencillos pasos.

A continuación detallo las instrucciones para instalar esta aplicación en Windows:

  • Instalo Python (http://www.python.org/download)
  • Instalo setuptools
    • Descargar y ejecutar el archivo peak.telecommunity.com/dist/ez_setup.py desde el intérprete de comandos (cmd)

C:Python27python.exe ez_setup.py

C:Python27python.exe setup.py install

Para Linux, es bastante sencillo, simplemente hace falta instalar Python, y posteriormente docutils y rst2pdf.

Ejemplos de utilización desde intérprete de comandos (cmd):

C:Python27Scriptsrst2html origen.rst destino.html

C:Python27Scriptsrst2pdf origen.rst -o destino.pdf