Le format RST (reStructuredText) est un format ouvert WYSIWYG très simple et très pratique, avec un rapport signal/bruit proche de l’optimal. Son cas d’utilisation typique est l’écriture de petits documents (TODO lists, résumés, courts articles, etc…). Il permet d’écrire des documents naturellement, avec simple éditeur de texte. Mais prenons plutôt un petit exemple :
================= Titre du document ================= Titre de section ================ Titre de sous-section --------------------- Titre de sous-sous-section ~~~~~~~~~~~~~~~~~~~~~~~~~~ ceci est un paragraphe ceci est un paragraphe ceci est un paragraphe ceci est un paragraphe ceci est un paragraphe ceci est un paragraphe ceci est un paragraphe ceci est un paragraphe ceci est un paragraphe ceci est un paragraphe ceci est un paragraphe. - Une liste - 2eme item * imbrication de listes * imbrication de listes, 2eme item - 3e item 1) liste ordonnée 2) suite de la liste ordonnée --------- Il y avait une ligne de séparation avant ce paragraphe. Une autre section ================= Les liens comme http://www.perdu.com sont transformés dans la version HTML. On peut aussi faire des liens avec des titres comme `ce lien <http://www.perdu.com>`
Et on peut exporter vers de l’HTML (XHTML 1.0 Transitional, en fait), du LaTeX (pour faire du PostScript ou du PDF) ou du XML (idéal si vous maitrisez XSLT). Le convertisseur vers l’HTML est suffisamment rapide pour l’exécuter depuis un fichier PHP : ca vous fait un moyen de lire facilement votre TODO list à distance.
Pour installer rst2html, rst2latex et rst2xml sous Debian, c’est le paquet python-docutils (RST étant utilisé pour écrire de la doc Python).
Si vous voulez en savoir plus :
- Le site du format RST : http://docutils.sourceforge.net/rst.html
- Une courte introduction : http://docutils.sourceforge.net/docs/user/rst/quickstart.html
- Une doc plus complète : http://docutils.sourceforge.net/docs/user/rst/quickref.html