summaryrefslogtreecommitdiff
path: root/content/Informatique/rstodt.rst
diff options
context:
space:
mode:
authorChimrod <contact+git@chimrod.com>2013-04-16 21:27:30 +0200
committerChimrod <contact+git@chimrod.com>2013-04-16 21:27:30 +0200
commit66a5a0cdccd464930a232c87f91e1b0805f255a5 (patch)
tree1563108cc22cfdc250108eb25b3beaf51d398dff /content/Informatique/rstodt.rst
initial commit
Diffstat (limited to 'content/Informatique/rstodt.rst')
-rwxr-xr-xcontent/Informatique/rstodt.rst59
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/
+