summaryrefslogtreecommitdiff
path: root/content/Informatique/2012-08-18-rstodt.rst
diff options
context:
space:
mode:
authorSébastien Dailly <sebastien@chimrod.com>2014-05-09 14:30:46 +0200
committerSébastien Dailly <sebastien@chimrod.com>2014-05-12 21:19:34 +0200
commitb9e22325bb46e2611a73e54a3f0ade31800d1bd9 (patch)
tree60b8aa46b47ec7fd4b8c8d62821aeef0b22be1a5 /content/Informatique/2012-08-18-rstodt.rst
parent23d7fb3e69d06b718a160c3ded763e6e6fbe3240 (diff)
Moved to pelican 3.3
Diffstat (limited to 'content/Informatique/2012-08-18-rstodt.rst')
-rw-r--r--content/Informatique/2012-08-18-rstodt.rst68
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/
+