.. -*- mode : rst -*-
.. -*-  coding: utf-8 -*-

Coloration syntaxique avec rst2odt
##################################

:date: 2012-08-18
:tags: Libre, reStructuredText
:logo: /images/kea.jpg
:summary: |summary|

.. figure:: {static}/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: {static}/resources/rstodt/rst2odt.py
.. _inclusion de fichier: http://rst2pdf.ralsina.com.ar/handbook.html#file-inclusion
.. _Kea: http://www.flickr.com/photos/k_e_a/3325975129/