diff options
Diffstat (limited to 'content/Informatique/rstodt.rst')
| -rwxr-xr-x | content/Informatique/rstodt.rst | 59 |
1 files changed, 59 insertions, 0 deletions
diff --git a/content/Informatique/rstodt.rst b/content/Informatique/rstodt.rst new file mode 100755 index 0000000..9011cb9 --- /dev/null +++ b/content/Informatique/rstodt.rst @@ -0,0 +1,59 @@ +.. -*- mode : rst -*- +.. -*- coding: utf-8 -*- + +Coloration syntaxique avec rst2odt +################################## + +:date: 2012-08-18 +:tags: Libre + +|logo| + +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 + +(Source de l'image : Kea_) + +.. |logo| image:: http://farm4.staticflickr.com/3609/3325975129_a8e246dd20_s.jpg +.. _article précédent: |filename|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/ + |