
        *****************************************************
        *           GENERATED FILE, DO NOT EDIT             *
        * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION *
        *****************************************************

This file was generated by po4a(7). Do not store it (in VCS, for example),
but store the PO file used as source file by po4a-translate.

In fact, consider this as a binary, and the PO file as a regular .c file:
If the PO get lost, keeping this translation up-to-date will be harder.

=encoding UTF-8

=head1 NOM

po4a - Mettre à jour à la fois les fichiers PO et les documents traduits

=head1 SYNOPSIS

B<po4a> [I<options>] I<fichier_de_configuration>

=head1 DESCRIPTION

po4a (PO for anything) facilite la maintenance de la traduction de la documentation en utilisant les outils gettext classiques. La principale caractéristique de po4a est qu'il découple la traduction du contenu de la structure du document.  Veuillez vous référer à la page L<po4a(7)> pour une introduction en douceur à ce projet.

Quand vous lancez le programme B<po4a> pour la première fois, avec seulement un fichier de configuration et des documents à traduire (appelés des documents maîtres), cela produit un fichier POT (aussi appelé un modèle de traduction) qui contient toutes les chaînes traduisibles dans le document sous une forme qui facilite le travail des traducteurs.

Ces fichiers POT peuvent être traduits via un éditeur dédié tel que le B<l’éditeur de traduction de GNOME>, B<Lokalize> de KDE ou B<poedit>, ou ils peuvent être intégrés dans une plateforme de traduction en ligne telle que B<weblate> ou B<pootle>. Le résultat des traductions est un ensemble de fichiers PO, un par langue.

Quand vous lancez le programme B<po4a> avec et document maître et les fichiers de traduction, il produit les documents traduits en injectant la traduction du contenu (trouvé dans les fichiers PO) dans la structure du document maître original.

Si les documents maître ont été changés entre temps, po4a va mettre à jour les fichiers PO et POT en conséquence, de façon à ce que les traducteurs puissent facilement détecter les modifications et mettre à jour leur travail. Selon vos paramètres, po4a éliminera les documents partiellement traduits, ou produire un document mélangeant anglais (pour les paragraphes nouveaux ou modifiés) et la langue cible (pour les paragraphes où la traduction est déjà dans le fichier PO).

Par défaut, les documents traduits sont produits quand au moins 80% de leur contenu est traduit (voir l'option I<--keep> ci-dessous). Il n'est pas recommandé de rejeter les traductions qui ne sont pas parfaitement traduites à 100% pour ne pas décourager les traducteurs, mais conserver des "traductions" trop partielles peut être troublant pour les utilisateurs.

=head2 Résumé graphique



 document maître --+--------------+
                   :              |
 prog de           :     doc      v
 filtrage =========X--> maître    |
 externe                filtré    +----> traductions
                          |       ^
                          V       |
 anciens fichiers PO ->---+--> fichiers PO à jour
      ^                           |
      |                           V
      +<..........................+

Les documents maîtres sont écrits par les rédacteurs de documentation. Tout changement est automatiquement reflété par po4a dans les fichiers PO, qui sont ensuite mis à jour par les traducteurs. Tous les changements sur les fichiers PO (manuels ou par po4a) sont automatiquement reflétés dans les documents traduits. Vous pouvez simuler ce comportement en utilisant les scripts L<po4a-updatepo(1)> et L<po4a-translate(1)> dans des makefiles, mais cela devient rapidement ennuyeux et répétitif (voir L<po4a(7)>). Il est fortement recommandé d’utiliser le programme B<po4a> dans votre processus de construction.

=head1 OPTIONS

=over 4

=item B<-k>, B<--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 sur le disque.

=item B<-h>, B<--help>

Affiche un message d’aide.

=item B<-M>, B<--master-charset>

Jeu de caractères des fichiers contenant les documents à traduire. Notez que tous les fichiers maîtres doivent utiliser le même jeu de caractères.

=item B<-L>, B<--localized-charset>

Jeu de caractères des fichiers contenant les documents traduits. Notez que tous les documents traduits doivent utiliser le même jeu de caractères.

=item B<-A>, B<--addendum-charset>

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

=item B<-V>, B<--version>

Affiche la version du script et quitte.

=item B<-v>, B<--verbose>

Rend le programme plus bavard.

=item B<-q>, B<--quiet>

Rend le programme moins bavard.

=item B<-d>, B<--debug>

Affiche quelques informations de débogage.

=item B<-o>, B<--option>

Passe une ou des options supplémentaires au greffon de format. Veuillez vous référer à la documentation de chaque greffon pour la liste des options valides et leurs significations. Par exemple, vous pourriez passer « -o tablecells » au parseur AsciiDoc, tandis que le parseur de texte accepterait « -o tabs=split ».

=item B<-f>, B<--force>

Génère toujours les fichiers POT et PO, même si B<po4a> considère que ce n’est pas nécessaire.

Le comportement par défaut (quand l’option B<--force> n’est pas utilisée) est le suivant :

=over 

Si le fichier POT existe déjà, il est recréé si un document maître ou le fichier de configuration est plus récent (sauf si l'option B<--no-update> est utilisée). De plus, le fichier POT est écrit dans un document temporaire, et B<po4a> vérifie que les modifications valent le coup.

De plus, une traduction est mise à jour seulement si le document maître, le fichier PO, un de ses addenda ou le fichier de configuration est plus récent. Pour éviter de retenter de créer une traduction qui ne passe pas le test du seuil (voir l’option B<--keep>), un fichier avec une extension F<.po4a-stamp> peut être créé (voir l’option B<--stamp>).

=back

Si un document maître inclut d’autres fichiers, vous devriez utiliser l’option B<--force> parce que les dates de modification de ces fichiers ne sont pas prises en compte.

Les fichiers PO sont toujours recréés en fonction du POT avec B<msgmerge -U>.

=item B<--stamp>

Indique à B<po4a> de créer des fichiers d’horodatage quand une traduction n’a pas été générée parce qu’elle ne dépasse pas le seuil de traduction. Ces fichiers d’horodatage sont nommés en ajoutant l’extension F<.po4a-stamp> au nom du fichier à générer.

S<Note :> Cette option ne concerne que la création des fichiers F<.po4a-stamp>. Ces fichiers d’horodatage sont toujours utilisés s’ils existent et sont retirés quand l’option B<--rm-translations> est utilisée ou quand le fichier est finalement traduit.

=item B<--no-translations>

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

=item B<--no-update>

Ne modifiez pas les fichiers POT et PO, seule la traduction peut être changée.

=item B<--keep-translations>

Garde les traductions existantes même si la traduction de satisfait pas le seuil spécifié par B<--keep>. Cette option ne va pas créer de fichiers peu traduits, mais elle préservera les fichiers existants dont la quantité de traduction décroît à cause de changements dans les fichiers maîtres.

ATTENTION ! Cette option change profondément le comportement de po4a. Vos fichiers traduits ne seront plus modifiés jusqu'à ce que la traduction soit améliorée. N'utilisez cette option que si vous préférez distribuer une traduction obsolète bien traduite plutôt qu'une traduction à jour mais mal traduite.

=item B<--rm-translations>

Supprime les documents traduits (implique B<--no-translations>).

=item B<--no-backups>

Cette option ne fait rien depuis la S<version 0.41,> et pourra être enlevée des prochaines versions.

=item B<--rm-backups>

Cette option ne fait rien depuis la S<version 0.41,> et pourra être enlevée des prochaines versions.

=item B<--translate-only> I<fichier-traduit>

Traduit uniquement le fichier indiqué. Il est parfois utile d’accélérer le processus si le fichier de configuration contient beaucoup de fichiers. Remarquez qu’avec cette option, les fichiers PO et POT ne seront pas mis à jour. Cette option peut être utilisée plusieurs fois.

=item B<--variable> I<var>B<=>I<valeur>

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

=item B<--srcdir> I<RÉP_SRC>

Définit le répertoire de base pour tous les documents d’entrée indiqués dans le fichier de configuration de B<po4a>.

Si I<destdir> et I<srcdir> sont renseignés, les fichiers d’entrée sont cherchés dans les dossiers suivants et dans cet ordre : I<destdir>, le dossier courant et I<srcdir>. Les fichiers de sortie sont écrits dans I<destdir> si renseigné, sinon dans le dossier courant.

=item B<--destdir> I<RÉP_DEST>

Définit le répertoire de base pour tous les documents de sortie indiqués dans le fichier de configuration de B<po4a> (voir B<--srcdir> ci-dessus).

=back

=head2 Options modifiant l’en-tête du POT

=over 4

=item B<--porefs> I<type>

Indique le format des références. L’argument I<type> peut-être B<never> pour ne pas produire de référence, B<file> pour n’indiquer que le fichier sans le numéro de ligne, B<counter> pour remplacer le numéro de ligne par un décompte croissant, et B<full> pour inclure des références complètes (par défaut, la valeur full est utilisée).

=item B<--wrap-po> B<no>|B<newlines>|I<nombre> (par défaut : 76)

Détermine la façon de formater le fichier po. Cela donne le choix entre des fichiers joliment reformatés mais pouvant mener à des conflits git, ou des fichiers plus facile à prendre en main automatiquement, mais plus difficile à lire pour les humains.

Historiquement, la suite gettext a formaté les fichiers po à la 77e colonne pour des raisons cosmétiques. Cette option indique le comportement de po4a. Si défini en tant qu’entier, po4a va restreindre la largeur du fichier après cette colonne et après les nouvelles lignes de contenu. Si défini à B<newlines>, po4a ne séparera les msgit et msgstr qu’après les nouvelles lignes dans le contenu. Si défini à B<no>, po4a ne restreindra pas du tout le fichier. Les commentaires de référence sont toujours limités par les outils gettext que nous utilisons en interne.

Veuillez noter que cette option n’a pas d’impact sur la façon dont les msgid et msgstr sont restreints, par exemple sur la façon dont les nouvelles lignes sont ajoutées au contenu de ces chaînes.

=item B<--master-language>

Langue des fichiers source contenant les documents à traduire. Notez que tous les fichiers maîtres doivent partager la même langue.

=item B<--msgid-bugs-address> B<adresse@email>

Fixe l’adresse à laquelle les bogues des msgid doivent être envoyés. Par défaut, les fichiers POT créés n’ont pas de champ Report-Msgid-Bugs-To.

=item B<--copyright-holder> I<chaîne>

Fixe le détenteur du copyright dans l’en-tête du fichier POT. La valeur par défaut est S<« Free> Software Foundation, S<Inc. ».>

=item B<--package-name> I<chaîne>

Fixe le nom du paquet pour l’en-tête du fichier POT. La valeur par défaut est S<« PACKAGE ».>

=item B<--package-version> I<chaîne>

Fixe la version du paquet pour l’en-tête du fichier POT. La valeur par défaut est S<« VERSION ».>

=back

=head2 Options de modification des fichiers PO

=over 4

=item B<--msgmerge-opt> I<options>

Options additionnelles pour B<msgmerge>(1).

S<Note :> B<$lang> sera remplacé par la langue en cours.

=item B<--no-previous>

Cette option supprime B<--previous> des options passées à B<msgmerge>. Elle permet de prendre en charge les versions de B<gettext> antérieures à 0.16.

=item B<--previous>

Cette option ajoute B<--previous> aux options passées à B<msgmerge>. Elle nécessite une version 0.16 ou ultérieure de B<gettext> et est activée par défaut.

=back

=head1 FICHIER DE CONFIGURATION

po4a attend un fichier de configuration en paramètre. Ce fichier doit contenir les éléments suivants :

=over 

=item 

Le chemin vers les fichiers PO et la liste ds langues existantes dans le projet ;

=item 

En option, quelques options globales et ce qu’on appelle des alias de configuration utilisés en tant que modèles pour configurer des fichiers maîtres individuels ;

=item 

La liste de chaque fichier maître à traduire, avec les paramètres spécifiques.

=back

Toutes les lignes contiennent une commande entre crochets, suivie de ses paramètres. Les commentaires commencent par le caractère «#» et vont jusqu'à la fin de la ligne. Vous pouvez échapper la fin de la ligne (avec \) pour étaler une commande sur plusieurs lignes.

Quelques exemples complets sont présentés sur cette page, tandis que d'autres exemples peuvent être trouvés dans le répertoire C<t/cfg> de la distribution source.

=head2 Trouver les fichiers PO et POT

La solution la plus simple est de donner explicitement le chemin des fichiers POT et PO, comme ceci :

 [po4a_paths] man/po/project.pot de:man/po/de.po fr:man/po/fr.po

Cela spécifie d'abord le chemin d'accès au fichier POT, puis les chemins d'accès aux fichiers PO allemand et français.

La même information peut être écrite comme suit pour réduire le risque d'erreurs de copier/coller :

 [po4a_langs] fr de
 [po4a_paths] man/po/project.pot $lang:man/po/$lang.po

L'élément C<$lang> est automatiquement développé à l'aide de la liste de langues fournie, ce qui réduit le risque d'erreur de copier/coller lorsqu'une nouvelle langue est ajoutée.

Vous pouvez en outre compacter les mêmes informations en fournissant uniquement le chemin d'accès au répertoire contenant votre projet de traduction, comme suit.

 [po_directory] man/po/

Le répertoire fourni doit contenir un ensemble de fichiers PO, nommés F<XX.po>, C<XX> étant le code ISO 639-1 de la langue utilisée dans ce fichier. Le répertoire doit également contenir un seul fichier POT, avec l'extension de fichier C<.pot>. Pour la première exécution, ce fichier peut être vide mais il doit exister (po4a ne peut pas deviner le nom à utiliser avant l'extension).

Notez bien que vous devez choisir entre C<po_directory> et C<po4a_paths>. Le premier (C<po_directory>) est plus compact, réduit le risque d'erreur de copier/coller, mais vous oblige à utiliser la structure de projet et les noms de fichiers attendus. Le second (C<po4a_paths>), est plus explicite, probablement plus lisible, et conseillé lorsque vous configurez votre premier projet avec po4a.

=head3 Fichier PO unique ou fractionné ?

Par défaut, po4a produit un seul fichier PO par langue cible, contenant tout le contenu de votre projet de traduction. À mesure que votre projet se développe, la taille de ces fichiers peut devenir problématique. Lors de l'utilisation de weblate, il est possible de spécifier des priorités pour chaque segment de traduction (c'est-à-dire, msgid) afin que les plus importants soient traduits en premier. Toutefois, certaines équipes de traduction préfèrent diviser le contenu en plusieurs fichiers.

Pour avoir un fichier PO par fichier maître, il vous suffit d'utiliser la chaîne C<$master> dans le nom de vos fichiers PO sur la ligne C<[po4a_paths]>, comme suit.

 [po4a_paths] doc/$master/$master.pot $lang:doc/$master/$lang.po

With this line, po4a will produce separate POT and PO files for each document to translate.  For example, if you have 3 documents and 5 languages, this will result in 3 POT files and 15 PO files. These files are named as specified on the C<po4a_paths> template, with C<$master> substituted to the basename of each document to translate. In case of name conflict, you can specify the POT file to use as follows, with the C<pot=> parameter.  This feature can also be used to group several translated files into the same POT file.

 [po4a_langs] de fr ja
 [po4a_paths] l10n/po/$master.pot $lang:l10n/po/$master.$lang.po
 [type: xml] foo/gui.xml $lang:foo/gui.$lang.xml pot=foo-gui
 [type: xml] bar/gui.xml $lang:bar/gui.$lang.xml pot=bar
 [type: xml] bar/cli.xml $lang:bar/cli.$lang.xml pot=bar

En mode réparti, B<po4a> construit un compendium temporaire pendant la mise à jour des PO afin de partager les traductions entre l’ensemble des fichiers PO. Si deux fichiers PO ont des traductions différentes pour la même chaîne, B<po4a> marquera ces deux chaînes comme étant approximatives (I<fuzzy>) et ajoutera les deux traductions dans tous les fichiers PO contenant cette chaîne. Une fois corrigée par le traducteur, la traduction sera automatiquement utilisée dans tous les fichiers PO.

=head2 Spécification des documents à traduire

Vous devez également lister les documents à traduire. Pour chaque fichier maître, vous devez spécifier l'analyseur de format à utiliser, l'emplacement du document traduit et éventuellement une configuration. Voici un exemple :

 [type: sgml] doc/my_stuff.sgml fr:doc/fr/mon_truc.sgml \
              de:doc/de/mein_kram.sgml
 [type: man] script fr:doc/fr/script.1 de:doc/de/script.1
 [type: docbook] doc/script.xml fr:doc/fr/script.xml \
             de:doc/de/script.xml

Mais là aussi, ces lignes complexes sont difficiles à lire et à modifier, par ex. lors de l'ajout d'une nouvelle langue. Il est beaucoup plus simple de réorganiser les choses en utilisant le modèle C<$lang> comme ceci :

 [type: sgml]    doc/mon_truc.sgml $lang:doc/$lang/mon_truc.sgml
 [type: man]     script.1          $lang:po/$lang/script.1
 [type: docbook] doc/script.xml    $lang:doc/$lang/script.xml

=head2 Renseigner les options

Il y a deux types d'options : les I<options po4a> sont les valeurs par défaut des options de ligne de commande po4a tandis que les I<options de format> sont utilisées pour changer le comportement des analyseurs de format. En tant qu' I<options po4a>, vous pouvez par exemple spécifier dans votre fichier de configuration que la valeur par défaut du paramètre de ligne de commande B<--keep> est 50% au lieu de 80%. Les <Options de format> sont documentées sur la page spécifique de chaque module d'analyse, par ex. L<Locale::Po4a::Xml(3pm)>. Vous pouvez par exemple passer B<nostrip> à l'analyseur XML pour ne pas supprimer les espaces autour des chaînes extraites.

Vous pouvez transmettre ces options pour un fichier maître spécifique, ou même pour une traduction spécifique de ce fichier, en utilisant C<opt:> et C<opt_XX:> pour la langue C<XX>. Dans l'exemple suivant, l'option B<nostrip> est passée à l'analyseur XML (pour toutes les langues), tandis que le seuil sera réduit à 0% pour la traduction française (qui est donc toujours conservée).

 [type:xml] toto.xml $lang:toto.$lang.xml opt:"-o nostrip" opt_fr:"--keep 0"

Dans tous les cas, ces blocs de configuration doivent être situés à la fin de la ligne. La déclaration des fichiers doit venir en premier, puis l'addendum le cas échéant (voir plus loin), et ensuite seulement les options. Le regroupement des blocs de configuration n'est pas très important, car les éléments sont concaténés en interne sous forme de chaînes. Les exemples suivants sont tous équivalents :

  [type:xml] toto.xml $lang:toto.$lang.xml opt:"--keep 20" opt:"-o nostrip" opt_fr:"--keep 0"
  [type:xml] toto.xml $lang:toto.$lang.xml opt:"--keep 20 -o nostrip" opt_fr:"--keep 0"
  [type:xml] toto.xml $lang:toto.$lang.xml opt:--keep opt:20 opt:-o opt:nostrip opt_fr:--keep opt_fr:0

Notez que les options spécifiques à la langue ne sont pas utilisées lors de la création du fichier POT. Il est par exemple impossible de passer B<nostrip> à l'analyseur uniquement lors de la construction de la traduction française, car le même fichier POT est utilisé pour mettre à jour toutes les langues. Ainsi, les seules options qui peuvent être spécifiques à la langue sont celles qui sont utilisées lors de la production de la traduction, comme l'option C<--keep>.

=head3 Configuration des alias

Pour transmettre les mêmes options à plusieurs fichiers, le mieux est de définir un alias de type comme suit. Dans l'exemple suivant, C<--keep 0> est passé à chaque traduction italienne en utilisant ce type C<test>, qui est une extension du type C<man>.

  [po4a_alias:test] man opt_it:"--keep 0"
  [type: test] man/page.1 $lang:man/$lang/page.1

Vous pouvez également étendre un type existant en réutilisant le même nom pour l'alias comme suit. Cela n’est pas interprété en tant que définition récursive erronée.

  [po4a_alias:man] man opt_it:"--keep 0"
  [type: man] man/page.1 $lang:man/$lang/page.1

=head3 Options globales par défaut

Vous pouvez également utiliser les lignes d’C<[options]> pour définir des options devant être utilisées pour tous les fichiers, indépendamment de leur type.

  [options] --keep 20 --option nostrip

Comme pour les options en ligne de commande, vous pouvez abbréger les paramètres passés dans le fichier de configuration :

  [options] -k 20 -o nostrip

=head3 Priorités des options

Les options de toutes les sources sont concaténées, assurant que les valeurs par défaut puissent facilement être remplacées par des options plus spécifiques. L’ordre est le suivant :

=over 

=item 

Les lignes C<[options]> fournissent les valeurs par défaut pouvant être remplacées par n’importe quel autre source.

=item 

Puis les alias de types sont utilisés. Les paramètres spécifiques de langue remplacent ceux applicables à toutes les langues.

=item 

Les paramètres étant spécifiques à un fichier master remplacement celles par défaut et celles venant du type alias. Dans ce cas également, les paramètres spécifiques de langue remplacent les globaux.

=item 

Enfin, les paramètres fournis via la ligne de commande B<po4a> remplacement tout paramètre du fichier de configuration.

=back

=head3 Exemple

Voici un exemple montrant comment renseigner les espaces et apostrophes :

 [po_directory] man/po/
 
 [options] --master-charset UTF-8
 
 [po4a_alias:man] man opt:"-o \"mdoc=NAME,SEE ALSO\""
 [type:man] t-05-config/test02_man.1 $lang:tmp/test02_man.$lang.1 \
            opt:"-k 75" opt_it:"-L UTF-8" opt_fr:--verbose

=head2 S<Addendum :> Ajouter des contenus dans la traduction

Si vous souhaitez ajouter une section supplémentaire à la traduction, par exemple pour donner du crédit au traducteur, vous devez définir un addendum à la ligne définissant votre fichier maître. Veuillez vous référer à la page L<po4a(7)> pour plus de détails sur la syntaxe des fichiers addendum.

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

Vous pouvez également utiliser des modèles de langue comme suit :

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

Si l'application d'un addendum échoue, la traduction est rejetée.

=head3 Modificateurs pour la déclaration d'un addendum

Les modificateurs d'addendum peuvent simplifier le fichier de configuration dans le cas où toutes les langues ne fournissent pas d'addendum, ou lorsque la liste des addenda change d'une langue à l'autre. Le modificateur est un seul caractère situé avant le nom du fichier.

=over 2

=item B<?>

Inclure l’I<addendum> si le fichier existe, rien sinon.

=item B<@>

I<addendum> n’est pas un fichier addendum normal mais un fichier contenant une liste d’addenda, un par ligne. Chaque addendum peut être précédé de modificateurs.

=item B<!>

I<addendum> n’est pas pris en compte, il n’est pas chargé et ne le sera pas lors de toute autre indication d’addendum.

=back

Ce qui suit inclut un addendum dans n'importe quelle langue, mais seulement s'il existe. Aucune erreur n'est signalée si l'addendum n'existe pas.

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

Ce qui suit inclut un addendum pour chaque langue :

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

=head2 Filtrer les chaînes traduites

Parfois, vous souhaitez masquer certaines chaînes au processus de traduction. Pour cela, vous pouvez donner un paramètre C<pot_in> à votre fichier maître pour spécifier le nom du fichier à utiliser à la place du vrai maître lors de la construction du fichier POT. Voici un exemple :

  [type:docbook] book.xml          \
          pot_in:book-filtered.xml \
          $lang:book.$lang.xml

Avec ce paramètre, les chaînes à traduire seront extraites du F<book-filtered.xml> (qui doit être créé avant d'appeler B<po4a>) tandis que les fichiers traduits seront construits à partir de F<book.xml>. Par conséquent, toute chaîne qui fait partie de F<book.xml> mais pas de F<book-filtered.xml> ne sera pas incluse dans les fichiers PO, empêchant les traducteurs de fournir une traduction pour eux. Ainsi, ces chaînes ne seront pas modifiées lors de la production des documents traduits. Cela diminue naturellement le niveau de traduction, vous pouvez donc avoir besoin de l'option C<--keep> pour vous assurer que le document est produit dans tous les cas.

=head2 EXEMPLE DE CONFIGURATION

À VOIR : Cette section est-elle vraiment utile ?

Considérons que vous soyez responsable d’un programme B<truc> avec sa page de manuel F<man/truc.1> naturellement maintenue seulement en anglais. Maintenant, en tant que développeur amont ou responsable aval, vous désirez créer et maintenir la traduction. Vous devez d’abord créer le fichier POT nécessaire à envoyer au traducteur avec L<po4a-gettextize(1)>.

Ainsi dans notre cas, nous ferons

 cd man && po4a-gettextize -f man -m truc.1 -p truc.pot

Vous pourrez alors envoyer ce fichier aux listes de traductions adéquates ou le rendre disponible au téléchargement quelque part.

Considérons maintenant que vous receviez trois traductions avant la prochaine S<publication :> F<de.po> (avec un addendum F<de.add>), F<sv.po> et F<pt.po>.  Puisque vous n’avez pas l’intention de modifier le ou les fichiers F<Makefile> à chaque nouvelle traduction reçue, vous pouvez utiliser B<po4a> avec le fichier de configuration adéquat dans chaque F<Makefile>. Ce fichier de configuration peut s’appeler F<po4a.cfg>, dans cet exemple, il ressemblerait S<à :>

 [po_directory] man/po4a/po/

 [type: man] man/foo.1 $lang:man/translated/$lang/foo.1 \
            add_$lang:?man/po4a/add_$lang/$lang.add opt:"-k 80"

Dans cet exemple, nous considérons que les pages de manuel créées (ainsi que tous les fichiers PO et addenda) devraient être gardés dans F<man/translated/$lang/> (respectivement dans F<man/po4a/po/> et F<man/po4a/add_$lang/>) à l’intérieur du répertoire en cours. Ici le répertoire F<man/po4a/po/> contiendrait F<de.po>, F<pt.po> et F<sv.po> et le répertoire F<man/po4a/add_de/> contiendrait F<de.add>.

Remarquez l’utilisation du modificateur B<?> car seule la traduction allemande (F<de.po>) est accompagnée d’un addendum.

Pour vraiment construire les pages de manuel traduites, vous devrez alors (une seule fois) ajouter la ligne suivante dans la cible B<build> du F<Makefile> S<adéquat :>

        po4a po4a.cfg

Une fois configuré, il ne sera plus nécessaire de modifier le F<Makefile> à chaque nouvelle traduction reçue. Si par exemple l’équipe de traduction française vous envoie F<fr.po> et F<fr.add>, il suffit de les déposer respectivement dans F<man/po4a/po/> et F<man/po4a/add_fr/> et la prochaine fois que le programme sera construit, la traduction française sera aussi automatiquement construite dans F<man/translated/fr/>.

Notez que vous avez toujours besoin d’une cible adéquate pour installer les pages de manuel traduites en plus de celles en anglais.

Enfin, si vous ne voulez pas garder les fichiers créés dans le système de gestion de version,
vous devriez aussi ajouter cette ligne à la cible S<B<clean> :>
        -rm -rf man/translated

=head1 VOIR AUSSI

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

=head1 AUTEURS

 Denis Barbier <barbier@linuxfr.org>
 Nicolas François <nicolas.francois@centraliens.net>
 Martin Quinson (mquinson#debian.org)


=head1 TRADUCTION

 Martin Quinson (mquinson#debian.org)

=head1 COPYRIGHT ET LICENCE

Copyright 2002-2020 by SPI, inc.

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

