reStructuredText texto re-estrucuturado
index | OSiUX | archive | charlas | docs | links
dot |
git |
img |
plt |
tty |
uml
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/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
Generar Latex
rst2latex presentacion.txt presentacion.tex
Aplicaciones
Wordpress
Drupal
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
2021-02-06 19:07agrego reStructuredText texto re-estructurado