Sphinx et docutils

Docutils

Il y a des librairies de bas niveau qui permettent de générer de l’odt, je pense à pyUNO, ou bien ezodf

A l’opposé, il y a des librairies de très haut niveau intégré à des chaînes de documentation avec des sources en xml, des modèles documentaires, des chartes graphiques, etc. Par exemple, scenari

Un juste milieu est la très intéressante librairie docutils :

Il s’agit d’une libairie python très utilisée dans le monde python (par exemple, la documentation officielle python est rédigée en syntaxe docutils).

C’est une syntaxe wiki assez puissante, un sur-ensemble de la très connue syntaxe markdown.

Pour l’installer:

apt-get install python-docutils

Il y a plusieurs utilitaires : rst2html, rst2*, l’utilitaire que je te conseille est : rst2odt.

Pour l’usage de rst2odt c’est simple, on part d’un fichier texte formaté en restructured text:

rst2odt fichier.txt > fichier.odt

Et voilà simple, pratique, efficace.

C’est l’outil que nous utilisons en priorité. Voici un exemple d’usage avancé avec l’utilisation d’un modèle:

rst2odt --create-links --file-insertion-enabled --raw-enabled --endnotes-end-doc \
        --stylesheet=styles/styles.odt --custom-odt-footer="XXXREMPLACEHEADERXXX" \
        DossierCommercial.rst > DossierCommercial.odt

La documentation technique

L’outil sphinx