
        *****************************************************
        *           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-translate - Convertir un fichier PO en fichier de documentation

=head1 SYNOPSIS

B<po4a-translate> B<-f> I<fmt> B<-m> I<chapi.doc> B<-p> I<XX.po> B<-l>
I<XX.doc>

(I<XX.doc> est le fichier de sortie, les autres sont des entrées)

=head1 DESCRIPTION

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 script B<po4a-translate> sert à reconvertir la traduction (faite dans un
fichier PO) dans le format d’origine. Le fichier PO fourni devrait être la
traduction du fichier POT produit par L<po4a-gettextize(1)>.

=head1 OPTIONS

=over 4

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

Type de format de la documentation que vous souhaitez traiter. Utilisez
l’option B<--help-format> pour afficher la liste des formats disponibles.

=item B<-a>, B<--addendum>

Ajoute le contenu d’un fichier dans le résultat (pour ajouter le nom des
membres des équipes de traduction ou une section nommée S<« À> propos de
cette S<traduction »>, par exemple). La première ligne du fichier à ajouter
(l’S<« addendum »>) doit être un en-tête valable indiquant où l’ajout doit
avoir lieu (voir la section B<Comment ajouter des choses qui ne sont pas des
traductions> dans L<po4a(7)>).

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

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

=item B<-m>, B<--master>

Fichier contenant les documents d'origine à traduire.

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

Jeu de caractères du fichier contenant les documents à traduire.

=item B<-l>, B<--localized>

Fichier où sera écrit le document traduit.

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

Jeu de caractères du fichier contenant le document traduit.

=item B<-p>, B<--po>

Fichier contenant le catalogue de messages à lire.

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

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

=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.

=item B<-w>, B<--width>

Column at which we should wrap the resulting file if the format supports it
(default: 76).  If the provided value is 0 or negative, then the resulting
file will not be wraped at all.  This is useful with some formats that could
break when rewraped.

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

Affiche un message d’aide.

=item B<--help-format>

Énumère les formats de documentations connus de po4a.

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

Affiche la version du script et quitte.

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

Rend le programme plus bavard.

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

Affiche quelques informations de débogage.

=back

=head1 Ajouter du contenu (en plus de la traduction) aux fichiers générés

Pour ajouter du contenu autre que la traduction aux fichiers générés (comme
le nom des membres des équipes de traduction ou une section à propos de la
traduction), vous devez utiliser l’option B<--addendum>.

La première ligne de l’addendum doit être un en-tête indiquant où l’ajout
doit avoir lieu dans le fichier généré (cela peut être après ou avant une
partie donnée du document). Le reste du fichier sera ajouté sans
modification dans le fichier généré.

Remarquez que si l’ajout de l’un des fichiers échoue, la traduction complète
est abandonnée (car le fichier manquant pourrait être celui indiquant le nom
des responsables, ce qui empêcherait de les contacter pour leur signaler des
erreurs de traduction).

Les en-têtes ont une syntaxe relativement rigide. Référez-vous à la page de
manuel L<po4a(7)> pour en savoir plus.

=head1 VOIR AUSSI

L<po4a-gettextize(1)>, L<po4a-normalize(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-2023 SPI, inc.

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