po4a - met à jour à la fois les fichiers po et les documents traduits

po4a [-dhvV] <fichier_de_configuration>

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.

Le programme CWpo4a est chargé de mettre à jour à la fois les fichiers po (les synchroniser avec les documents originaux) et les documents traduits (les synchroniser avec les fichiers po). Le principal avantage est de faciliter l'utilisation de po4a sans avoir besoin de se souvenir des options en lignes de commande.

Il vous permet de mélanger des documents de différents formats dans le même fichier pot de façon à n'en avoir qu'un seul par projet.

Ce comportement peut être imité par les autres outils de la suite po4a (par exemple avec des makefiles), mais il est relativement difficile à faire, et fatiguant de toujours refaire les mêmes makefiles compliqués pour chaque projet utilisant po4a.

Le flux des données peut se résummer de la façon suivante. Tout changement dans le document d'origine est reflété dans les fichiers po, et tout changement dans les fichiers po (qu'il soit manuel ou causé par une des étapes précédentes) sera reflété dans les documents traduits.

 document maître --> fichiers po --> traductions

Le flux de données ne peut pas être inversé dans cet outil, et les changements dans les traductions sont écrasés par le contenu des fichiers po. Cet outil ne peut donc pas être utilisé pour convertir les traductions existantes à po4a. Pour ceci, veuillez consulter po4a-gettextize(1).

Le paramètre (obligatoire) indique le chemin du fichier du fichier de configuration à utiliser. Sa syntaxe a vocation d'être simple et proche des autres fichiers de configuration utilisés par les projets d'internationalisation.

Des commentaires peuvent être ajoutés à ce fichier avec le caractère « # ». Tout ce qui suit ce caractère sur une ligne est considéré comme un commentaire. Les lignes peuvent se poursuivre en ajoutant un caractère d'échappement à la fin de la ligne. Toute ligne non vide doit débuter par une commande entre crochets, suivie de ses paramètres. (Ça peut paraître difficile à première vue, mais c'est en fait assez simple, enfin je l'espère ;)

C'est une commande optionelle qui permet de simplifier le fichier de configuration lorsqu'il est utilisé pour de nombreux langages. Il vous suffit de spécifier les langues vers lesquelles vous voulez traduire les documents, ce qui se fait aussi simplement que :

 [po4a_langs] fr de

Ceci vous permettra de développer CW$lang en tous les langages spécifiés pour le reste du fichier de configuration.

D'abord, vous devez spécifier où se trouvent les fichiers fournis aux traducteurs. Ceci peut être fait de la façon suivante :

 [po4a_paths] doc/l10n/project.doc.pot fr:doc/l10n/fr.po de:doc/l10n/de.po

La commande est donc « po4a_paths ». Le premier paramètre est le chemin du fichier pot à utiliser. Les autres paramètres se comprennent par eux-mêmes :

    <langue>:<chemin vers le fichier po de cette langue>

Si vous avez défini un modèle pour les langues, vous pouvez écrire la ligne précédente de cette façon :

 [po4a_paths] doc/l10n/project.doc.pot $lang:doc/l10n/$lang.po

Vous devez maintenant spécifier quels documents doivent être traduits, leur format et où placer leur traduction. Ceci peut être fait par ces lignes :

 [type: sgml] doc/my_stuff.sgml fr:doc/fr/mon_truc.sgml \
              de:doc/de/mein_cram.sgml
 [type: pod] script fr:doc/fr/script.1 de:doc/de/script.1 \
             add_fr:doc/l10n/script.fr.add

Ceci est plutôt explicite. Notez que dans le second cas, doc/l10n/script.fr.add est un addendum à ajouter à la version française du document. Veuillez vous référer à po4a(7) pour plus d'informations à propos des addenda.

Plus formellement, le format est le suivant :

 [type: <format>] <doc_maître> <lang>:<doc_traduit>* add_<lang>:<addendum>*

Si vous avez défini un modèle pour les langues, vous pouvez écrire la ligne précédente de cette façon :

 [type: pod] script $lang:doc/$lang/script.1 \
             add_fr:doc/l10n/script.fr.add

Sous toutes les langues ont des addenda situés dans des chemins similaires, vous pourriez également écrire quelque chose comme :

 [type: pod] script $lang:doc/$lang/script.1 \
             add_$lang:doc/l10n/script.$lang.add

po4a accepte des options qui seront passées au module. Ces options sont spécifiques au module et sont spécifiées avec l'option -o.

Si vous voulez fournir une option spécifique pour un des documents que vous voulez traduire, vous pouvez la préciser dans le fichier de configuration. Les options sont introduites par le mot clé opt. Les paramètres du mot clé opt doivent être placés entre guillemets s'ils contiennent un espace (par exemple si vous précisez plusieurs options, ou une option avec un paramètre). Vous pouvez également spécifier des options qui ne s'appliqueront qu'à une seule langue en utilisant le mot clé opt_lang.

Il y a des limitations connues : vous ne pouvez pas spécifier de paramètre contenant un espace ou des guillemets pour une option d'un module.

Voici un exemple : [type:man] data-05/test2_man.1 CW$lang:tmp/test2_man.$lang.1 \ opt:-k 75 opt_it:-L UTF-8 opt_fr:-v

Si vous devez fournir les mêmes options pour plusieurs fichiers, vous avez intérêt à définir un alias de module. Ceci se fait de cette façon :

[po4a_alias:test] man opt:-k 21 opt_es:-o debug=splitargs

Ceci définit un alias de module nommé test, basé sur le module man. L'option -k 21 s'appliquera à tous les languages et l'option -o debug=splitargs uniquement à l'espagnol.

Cet alias de module peut ensuite être utilisé comme un module normal :

[type:test] data-05/test2_man.1 CW$lang:tmp/test2_man.$lang.1 \ opt_it:-L UTF-8 opt_fr:-v

Notez que vous pouvez encore ajouter des options fichier par fichier.

-k, --keep

Seuil à dépasser afin que le fichier généré soit conservé et écrit sur disque (80 par défaut). C'est-à-dire que par défaut, les fichiers générés doivent être traduits à plus de 80% pour être écrits.

-h, --help

Affiche un message d'aide.

-M, --master-charset

Jeu de caractères des fichiers contenant les documents à traduire. Notez que tous les documents maîtres doivent partager le même jeu de caractères pour l'instant. C'est une limitation connue ; nous travaillons à sa résolution.

-L, --localized-charset

Jeu de caractères des fichiers contenant les documents traduits. Notez que tous les documents traduits doivent partager le même jeu de caractères pour l'instant. C'est une limitation connue ; nous travaillons à sa résolution.

-A, --addendum-charset

Jeu de caractères des addenda. Notez que tous les ajouts doivent partager le même jeu de caractères.

-V, --version

Affiche la version du script et quitte.

-v, --verbose

Rend le programme plus bavard.

-q, --quiet

Rend le programme moins bavard.

-d, --debug

Affiche quelques informations de debogage.

-f, --force

Génère toujours les fichiers POT et PO, même si po4a considère que ce n'est pas nécessaire. Le comportement par défaut (quand l'option --force n'est pas utilisée) est le suivant : Si le fichier POT existe déjà, il est regénéré si un document maître est plus récent. De plus, le fichier POTest écrit dans un document temporaire, et po4a vérifie que les modifications valent le coût. Les fichiers PO sont regénéré en fonction du champ POT-Creation-Date du POT et des fichier PO.

--no-translations

Ne génère pas les documents traduits, ne mets que à jour les fichiers POT et PO.

--rm-translations

Supprime les documents traduits (implique --no-translations).

--no-backups

Ne génère pas les fichiers .po~ de sauvegarde.

--rm-backups

Supprime les fichiers .po~ de sauvegarde (implique --no-backups).

--variable var=valeur

Définit une variable dont toutes les occurrences seront remplacées dans le fichier de configuration de po4a. Les occurrences de $(var) seront remplacées par valeur. Cette option peut être utilisée plusieurs fois.

•

Duplique du code des autres programmes de la suite po4a.

Toute rustine est la bien venue ;)

po4a(7), po4a-gettextize(1), po4a-updatepo(1), po4a-translate(1), po4a-normalize(1).

 Denis Barbier <barbier@linuxfr.org>
 Martin Quinson (mquinson#debian.org)

 Martin Quinson (mquinson#debian.org)

Copyright 2002, 2003, 2004 par SPI, inc.

Ce programme est un logiciel libre ; vous pouvez le copier et / ou le modifier sous les termes de la GPL (voir le fichier COPYING).