diff options
Diffstat (limited to 'content/Informatique/2012-08-18-rstodt.rst')
| -rw-r--r-- | content/Informatique/2012-08-18-rstodt.rst | 68 |
1 files changed, 68 insertions, 0 deletions
diff --git a/content/Informatique/2012-08-18-rstodt.rst b/content/Informatique/2012-08-18-rstodt.rst new file mode 100644 index 0000000..f99b5bc --- /dev/null +++ b/content/Informatique/2012-08-18-rstodt.rst @@ -0,0 +1,68 @@ +.. -*- mode : rst -*- +.. -*- coding: utf-8 -*- + +Coloration syntaxique avec rst2odt +################################## + +:date: 2012-08-18 +:tags: Libre, reStructuredText +:logo: /images/kea.jpg +:summary: |summary| + +.. figure:: {filename}/images/kea.jpg + :figwidth: 75 + :figclass: floatleft + :alt: Arbre + + Image : Kea_ + + +|summary| + +.. |summary| replace:: + Le langage rst, déjà évoqué dans un `article précédent`_, possède plusieurs + formats sortie : pdf, odt, html, xml… Cependant, les outils pour générer la + sortie ne prennent pas tous les même paramètres, et il est difficile de + faire un fichier source qui soit compatible avec l'ensemble des + compilateurs. + +La coloration syntaxique +======================== + +La coloration syntaxique, par exemple, n'est pas traitée de la même manière +selon l'outil utilisé. Nous retrouvons deux directives : + +=========== =============================================== +Nom Outils +=========== =============================================== +code-block rst2pdf_, sphynx… +sourcecode rst2odt +=========== =============================================== + +La première est devenue un standard, la seconde n'est prise en compte que par +rst2odt (et est en plus un peu lourde à mettre en place). + +La modification +=============== + +Heureusement, c'est assez facile d'ajouter de nouvelles directives, et il est +possible de modifier le script à lancer pour prendre en compte la directive +code-block ! + +Vous pouvez télécharger le script modifié ici_. J'ai repris l'option +d'`inclusion de fichier`, mais je ne gère pas les limites (je n'en avais pas +besoin). + +Et voilà, ça s'utilise comme ça : + +.. code-block:: console + + $ python bin/rst2odt.py --strip-comments --stylesheet=resources/template.odt\ + --add-syntax-highlight source.rst source.odt + +.. _article précédent: {filename}2010-10-04-rst.rst +.. _rst2pdf: http://rst2pdf.ralsina.com.ar/ +.. _ici: http://chimrod.com/downloads/rst2odt.py +.. _inclusion de fichier: http://rst2pdf.ralsina.com.ar/handbook.html#file-inclusion +.. _Kea: http://www.flickr.com/photos/k_e_a/3325975129/ + |