Locale::Po4a::Docbook - Convertir les documents XML DocBook depuis ou
vers des fichiers PO
L’objectif du projet po4a [PO for anything — PO pour tout] est de
simplifier la traduction (et de façon plus intéressante, la
maintenance des traductions) en utilisant les outils gettext dans des domaines
pour lesquels ils n’étaient pas destinés, comme la
documentation.
Locale::Po4a::Docbook est un module permettant d’aider la traduction de
documents XML DocBook dans d’autres langues.
Ce module est complètement fonctionnel, puisqu’il repose sur le
module Locale::Po4a::Xml. Il ne fait que définir les balises et
attributs à traduire.
Le seul problème connu est qu’il ne supporte toujours pas les
entités, cela comprend l’inclusion d’entités dans
des fichiers, mais vous pouvez traduire la plupart de ces fichiers
séparément (à l’exception des fichiers
d’entités typiques), et il est généralement mieux
de les maintenir séparés.
Le comportement par défaut des modules fournis par le système est
réglé pour être sûr.
Par exemple, la valeur par défaut de la balise
<author> vise
à ce qu'elle apparaisse sous
<para>. Mais il se peut que
vous ne l'utilisiez que sous
<bookinfo>. Dans ce cas, vous pouvez
vouloir le traduire indépendamment pour chaque auteur.
Si vous n'appréciez pas le comportement par défaut du module xml
et de ses dérivés, vous pouvez spécifier certaines
options par lignes de commande afin de changer leur comportement. Par exemple,
vous pouvez ajouter ce qui suit au fichier de configuration po4a :
opt:"-k 0 -o nodefault=\"<bookinfo> <author>\" \
-o break=\"<bookinfo> <author>\" \
-o untranslated=\"<bookinfo>\" \
-o translated=\"<author>\""
Ceci remplace le comportement par défaut de
<bookinfo> et
< <author>, définit
<bookinfo> et
<author> pour interrompre le flux de données
d'entrée sur ces balises, définit
<bookinfo> pour
ne pas traduire son contenu balisé, et définit
<author> pour traduire son contenu balisé.
Locale::Po4a::TransTractor(3pm),
Locale::Po4a::Xml(3pm),
po4a(7)
Jordi Vilalta <[email protected]>
Martin Quinson (mquinson#debian.org)
Copyright © 2004 Jordi Vilalta <[email protected]>
Copyright © 2007-2009 Nicolas François <[email protected]>
Ce programme est un logiciel libre ; vous pouvez le copier et / ou le
modifier sous les termes de la GPL (voir le fichier COPYING).