reStructuredText texto re-estrucuturado

reST

Hace tiempo que vengo usando reStructuredText 1 también conocido como reST, y para empezar a escribir sobre el tema primero busqué e instalé el plugin para wordpress, es decir que este texto ya está escrito en reST. Lo hice desde una consola usando Vim y luego fue posteado haciendo copy + paste, aunque se puede postear directamente por email, algo muy útil es que tanto el archivo como el contenido en la base de wordpress son idénticos, y teniendo los archivos se puede realizar una búsqueda de posts usando grep y otros comando básicos de consola, también se puede dejar público el archivo reST por web por las dudas estará siempre disponible en http://pub.osiux.com/reStructuredText.txt

Qué es reStructuredText

Es un lenguaje creado para generar documentos de textos en varios formatos HTML, LaTeX, docbook y otros. La principal ventaja es que prácticamente no son necesarios Tags, se puede usar cualquier editor de texto, y al editar el documento en texto plano se asemeja bastante al resultado final, como se trata de un de texto plano es portatil, liviano y permite concentrarse en el contenido en lugar del formato. Al usarlo en wordpress solo se guarda el contenido del post en la base de datos y no código HTML.

Sintaxis

Es extremandamente simple, prácticamente es un texto plano con algunas convenciones:


normal
*italica*
**negrita**
``código``

================
titulo documento
================

-----------------------
subtitulo del documento
-----------------------

título capítulo 1
=================

título sección 1
----------------

título subsección 1.1
~~~~~~~~~~~~~~~~~~~~~

 * lista uno
 * lista dos

========= ========= =========
columna 1 columna 2 columna 3
========= ========= =========
fila      celda     celda
========= ========= =========

Instalación

apt install python-docutils

Generar HTML

rst2html presentacion.txt presentacion.htm

Generar Slides HTML

rst2s5 presentacion.txt presentacion.htm

Generar Latex

rst2latex presentacion.txt presentacion.tex

Aplicaciones

Vim

Para obtener el coloreo de la sintaxis sólo es necesario incluir al principio del documento la siguiente línea:


.. -*- mode: rst -*-

MoinMoin

MoinMoin parsea reST con sólo incluir #!rst entre triples llaves.


{{{#!rst

Texto *reST*

}}}

Python

Sphinx genera la documentación oficial de python usando reST.

reST se utiliza para la creación de los PEPs (Python Enhancement Proposals).

EpyDoc genera documentación para Python y soporta reST.

rst2a

Un interesante servicio web que al pasarle una url de un texto escrito en reST puede devolver el contenido en formato HTML o PDF eligiendo diferentes templates, esto evita tener instalado reST.

ChangeLog

Notas al pie de página:

1

http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html