po4a 0.40-1 - en to fr translation catalogue (193 entries)

note: type: =head1
en: NAME
fr: NOM

note: type: textblock
en: po4a - update both the po files and translated documents in one shot
fr: po4a - met à jour à la fois les fichiers PO et les documents traduits

note: type: textblock
en: po4a [options] E<lt>config_fileE<gt>
fr: po4a [options] E<lt>fichier_de_configurationE<gt>

note: type: textblock
en: The po4a (po for anything) project goal is to ease translations (and more interestingly, the maintenance of translations) using gettext tools on areas where they were not expected like documentation.
fr: 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.

note: type: textblock
en: The B<po4a> program is useful if you want to avoid calling L<po4a-gettextize(1)>, L<po4a-updatepo(1)>, and L<po4a-translate(1)> in complex Makefiles when you have multiple files to translate, different format, or need to specify different options for different documents.
fr: Le programme B<po4a> permet d'éviter d'appeler L<po4a-gettextize(1)>, L<po4a-updatepo(1)>, et L<po4a-translate(1)> dans des Makefiles compliqués quand plusieurs fichiers doivent être traduits, si différents formats sont utilisés, ou pour indiquer des options différentes suivants les documents.

note: type: =head1
en: Table of content
fr: Table des matières

note: type: textblock
en: This document is organized as follow:
fr: Ce document est organisé de la manière S<suivante :>

note: type: =head1
en: CONFIGURATION FILE SYNTAX
fr: SYNTAXE DU FICHIER DE CONFIGURATION

note: type: =head2
en: Specifying the template languages
fr: Spécifier un modèle pour les différentes langues

note: type: =head2
en: Specifying the paths to translator inputs
fr: Spécifier les chemins des fichiers des traducteurs

note: type: =head2
en: Autodetection of the paths and languages
fr: Détection automatique des chemins et langues

note: type: =head2
en: Specifying the documents to translate
fr: Spécification des documents à traduire

note: type: =head2
en: Specifying options for the modules
fr: Fournir des options aux modules

note: type: =head2
en: Specifying aliases
fr: Spécifier des alias

note: type: =head2
en: Split mode
fr: Mode réparti

note: type: =head2
en: EXAMPLE
fr: EXEMPLE

note: type: =head1
en: SHORTCOMINGS
fr: DÉFAUTS

note: type: =head1
en: AUTHORS
fr: AUTEURS

note: type: =head1
en: COPYRIGHT AND LICENSE
fr: COPYRIGHT ET LICENCE

note: type: textblock
en: The B<po4a> program is in charge of updating both the po files (to sync them to the original documents) and the translated documents (to sync them to the po files). The main point is to make the use of po4a easier without having to remember of the command line options.
fr: Le programme B<po4a> 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.

note: type: textblock
en: It also allows you to mix documents having different formats into the same pot file so that you can have only one such file per project.
fr: 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.

note: type: textblock
en: This behaviour can be mimicked by the other tools of the po4a suite (for example with makefiles), but it is rather difficult to do, and exhausting to redo the same complicated makefiles for each project using po4a.
fr: 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.

note: type: textblock
en: The dataflow can be summarized as follow. Any changes to the master document will be reflected in the po files, and all changes to the po files (either manual or caused by previous step) will be reflected in translation documents.
fr: Le flux des données peut se résumer 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.

note: type: verbatim
en:  master document --> po files --> translations
fr:  document maître --> fichiers PO --> traductions

note: type: textblock
en: The dataflow cannot be inversed in this tool, and changes in translations are overwritten by the content of the po files. As a matter of fact, this tool cannot be used to convert existing translations to the po4a system. For that task, please refer to L<po4a-gettextize(1)>.
fr: 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 L<po4a-gettextize(1)>.

note: type: textblock
en: The (mandatory) argument is the path to the configuration file to use.  Its syntax aims at being simple and close to the configuration files used by the intl-tools projects.
fr: Le paramètre (obligatoire) indique le chemin 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.

note: type: textblock
en: Comments in this files are noted by the char '#'. It comments everything until the end of the line. Lines can be continued by escaping the end of line.  All non blank lines must begin with a [] command, followed by its arguments.  (sound difficult said that way, but it is rather easy, I hope ;)
fr: Des commentaires peuvent être ajoutés à ce fichier avec le caractère S<« # »>. 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 S<l'espère ;)>

note: type: textblock
en: B<Note:> It is recommended to use [po_directory] rather than [po4a_langs] and [po4a_paths].  See section B<Autodetection of the paths and languages> below.
fr: B<Note :> L'utilisation de [po_directory] est préférable à [po4a_langs] et [po4a_paths] (voir B<Détection automatique des chemins et langues> plus bas).

note: type: textblock
en: This is an optional command that can simplify the whole config file, and will make it more scalable. You have to specify a list of the languages in which you want to translate the documents. This is as simple as:
fr: C'est une commande optionnelle 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 S<que :>

note: type: textblock
en: This will enable you to expand $lang to all the specified languages in the rest of the config file.
fr: Ceci vous permettra de développer $lang dans toutes les langues spécifiées pour le reste du fichier de configuration.

note: type: textblock
en: First, you have to specify where the translator input files (ie, the files used by translators to do their job) are located. It can be done by such a line:
fr: D'abord, vous devez spécifier où se trouvent les fichiers fournis aux traducteurs. Ceci peut être fait de la façon S<suivante :>

note: type: textblock
en: The command is thus 'po4a_paths'. The first argument is the path to the pot file to use. All subsequent arguments are of the self-explanatory form:
fr: La commande est donc S<« po4a_paths »>. Le premier paramètre est le chemin du fichier POT à utiliser. Les autres paramètres se comprennent par S<eux-mêmes :>

note: type: verbatim
en:     <lang>:<path to the po file for this lang>
fr:     <langue>:<chemin vers le fichier PO de cette langue>

note: type: textblock
en: If you've defined the template languages, you can rewrite the line above this way:
fr: Si vous avez défini un modèle pour les langues, vous pouvez écrire la ligne précédente de cette S<façon :>

note: type: textblock
en: You can also use $master to refer to the document basename. In this case, po4a will use a split mode: one POT and one PO (for each language) will be created for each document specified in the po4a configuration file.  See the B<Split mode> section.
fr: Vous pouvez également utiliser $master pour faire référence au nom (sans le chemin) du document. Dans ce cas, po4a utilisera un mode réparti : un POT et un PO (par langue) sera créé pour chaque document présent dans le fichier de configuration de po4a. Consultez la section B<Mode réparti>.

note: type: textblock
en: Another command can be used to specify the name of a directory where the PO and POT files are located.  When it is used, po4a will detect the POT file as the only "*.pot" file from the specified directory.  Po4a will also use the list of "*.po" files to define the list of languages (by stripping out the extension).  These languages will be used for the substitution of the $lang variable in the rest of the configuration file.
fr: Une autre commande peut être utilisée pour indiquer le nom d'un répertoire où se trouvent les fichiers PO et POT. Quand elle est utilisée, po4a détectera le fichier POT comme le seul fichier « *.pot » du répertoire indiqué. po4a utilisera aussi la liste de tous les fichiers « *.po » pour définir la liste des langues (en enlevant l'extension). Ces langues seront utilisées pour la substitution de la variable $lang dans le reste du fichier de configuration.

note: type: textblock
en: This command should not be used together with the po4a_langs or po4a_paths commands.
fr: Cette commande ne doit pas être utilisée avec les commandes po4a_langs ou po4a_paths.

note: type: textblock
en: When using this command, you have to create an empty POT file on the first invocation of po4a to let it know the name of the POT file.
fr: Lors de l'utilisation de cette commande, il est nécessaire de créer un fichier POT vide pour le premier appel à po4a afin qu'il connaisse le nom du fichier POT.

note: type: textblock
en: You now naturally have to specify which documents are translated, their format, and where to put the translations. It can be made by such lines:
fr: Vous devez maintenant spécifier quels documents doivent être traduits, leur format et où placer leurs traductions. Ceci peut être fait par ces S<lignes :>

note: type: textblock
en: This should be rather self-explanatory also. Note that in the second case, doc/l10n/script.fr.add is an addendum to add to the French version of this document.  Please refer to po4a(7) for more information about the addenda.
fr: 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.

note: type: textblock
en: More formally, the format is:
fr: Plus formellement, le format est le S<suivant :>

note: type: verbatim
en:  [type: <format>] <master_doc> (<lang>:<localized_doc>)* \
                      (add_<lang>:<modifiers>*<addendum_path>)*
fr:  [type: <format>] <doc_maître> (<lang>:<doc_traduit>)* \
                      (add_<lang>:<modificateurs>*<addendum>)*

note: type: textblock
en: If there is no modifier, I<addendum_path> is a path to an addendum.  Modifiers are
fr: En absence de modificateurs, I<addendum> est le chemin vers un addendum. Les modificateurs sont :

note: type: textblock
en: Include I<addendum_path> if this file does exist, otherwise do nothing.
fr: Inclure l'I<addendum> si le fichier existe, rien sinon.

note: type: textblock
en: I<addendum_path> is not a regular addendum but a file containg a list of addenda, one by line.  Each addendum may be preceded by modifiers.
fr: 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.

note: type: textblock
en: I<addendum_path> is discarded, it is not loaded and will not be loaded by any further addendum specification.
fr: 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.

note: type: textblock
en: If all the languages had addenda with similar paths, you could also write something like:
fr: Si toutes les langues ont des addenda situés dans des chemins similaires, vous pourriez également écrire quelque chose S<comme :>

note: type: textblock
en: po4a accepts options that will be passed to the module. These options are module specific and are specified with the -o switch.
fr: 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.

note: type: textblock
en: If you need a specific option for one of the document you want to translate, you can also specify it in the configuration file. Options are introduced by the I<opt> keyword. The argument of the I<opt> keyword must be quoted with double quotes if it contains a space (e.g. if you specify multiple options, or an option with an argument).  You can also specify options that will only apply to a specific language by using the opt_I<lang> keyword.
fr: 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é I<opt>. Les paramètres du mot clé I<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_I<lang>.

note: type: verbatim
en: Here is an example:
     [type:man] data-05/test2_man.1 $lang:tmp/test2_man.$lang.1 \
                opt:"-k 75" opt_it:"-L UTF-8" opt_fr:-v
fr: Voici un exemple :
     [type:man] data-05/test2_man.1 $lang:tmp/test2_man.$lang.1 \
                opt:"-k 75" opt_it:"-L UTF-8" opt_fr:-v

note: type: verbatim
en: Arguments may contain spaces if you use single quotes or escaped double
    quotes:
     [po4a_alias:man] man opt:"-o \"mdoc=NAME,SEE ALSO\" -k 20"
fr: Les arguments peuvent contenir des espaces si vous utilisez des guillemets simples ou si vous protégez les guillemets doubles comme ceci :
     [po4a_alias:man] man opt:"-o \"mdoc=NAME,SEE ALSO\" -k 20"

note: type: textblock
en: If you want to specify the same options for many documents, you may want to use an alias (see the B<Specifying aliases> section below).
fr: Pour préciser les mêmes options pour un jeu de documents, vous pouvez utiliser un alias (consultez la section B<Spécifier des alias> ci-dessous).

note: type: verbatim
en: You can also set options for all the documents specified in the
    configuration file:
     [options] opt:"..." opt_fr:"..."
fr: Vous pouvez aussi définir des options pour tous les documents du fichier de configuration :
     [options] opt:"..." opt_fr:"..."

note: type: textblock
en: If you must specify the same options for multiple files, you may be interested in defining a module alias. This can be done this way:
fr: 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 S<façon :>

note: type: textblock
en: This define a module alias named I<test>, based on the I<man> module, with the I<-k 21> apply to all the languages and with I<-o debug=splitargs> applied to the Spanish translation.
fr: Ceci définit un alias de module nommé I<test>, basé sur le module I<man>. L'option I<-k 21> s'appliquera à tous les langues et l'option I<-o debug=splitargs> uniquement à l'espagnol.

note: type: textblock
en: This module alias can then be use like a regular module:
fr: Cet alias de module peut ensuite être utilisé comme un module S<normal :>

note: type: textblock
en: Note that you can specify additional options on a per file basis.
fr: Notez que vous pouvez encore ajouter des options fichier par fichier.

note: type: textblock
en: The split mode is used when $master is used in the [po4a_paths] line.
fr: Le mode réparti est utilisé quand $master est utilisé dans la ligne [po4a_paths].

note: type: textblock
en: When the split mode is used, a temporary big POT and temporary big POs are used. This permits to share the translations between all the POs.
fr: Quand le mode réparti est utilisé, un gros POT et de gros POs sont créés temporairement. Ceci permet de partager les traductions entre tous les POs.

note: type: textblock
en: If two POs have different translations for the same string, po4a will mark this string as fuzzy and will submit both translations in all the POs which contain this string. Then, when a translator updates the translation and removes the fuzzy tag in one PO, the translation of this string will be updated in every POs automatically.
fr: Si deux POs ont deux traductions différentes pour la même chaîne, po4a marquera cette chaîne comme étant fuzzy et proposera les deux traductions dans tous les POs qui contiennent cette chaîne. Ensuite, lorsqu'un traducteur mettra à jour la chaîne dans un PO et retirera l'étiquette fuzzy, la traduction de cette chaîne sera mise à jour dans tous les POs automatiquement.

note: type: textblock
en: Minimal threshold for translation percentage to keep (ie, write) the resulting file (default: 80). Ie, by default, files have to be translated at at least 80% to get written.
fr: 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.

note: type: textblock
en: Show a short help message.
fr: Affiche un message d'aide.

note: type: textblock
en: Charset of the files containing the documents to translate. Note that all master documents must use the same charset for now. This is a known limitation, and we are working on solving this.
fr: 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 S<connue ;> nous travaillons à sa résolution.

note: type: textblock
en: Charset of the files containing the localized documents. Note that all translated documents will use the same charset for now. This is a known limitation, and we are working on solving this.
fr: 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 S<connue ;> nous travaillons à sa résolution.

note: type: textblock
en: Charset of the addenda. Note that all the addenda should be in the same charset.
fr: Jeu de caractères des addenda. Notez que tous les ajouts doivent partager le même jeu de caractères.

note: type: textblock
en: Display the version of the script and exit.
fr: Affiche la version du script et quitte.

note: type: textblock
en: Increase the verbosity of the program.
fr: Rend le programme plus bavard.

note: type: textblock
en: Decrease the verbosity of the program.
fr: Rend le programme moins bavard.

note: type: textblock
en: Output some debugging information.
fr: Affiche quelques informations de débogage.

note: type: textblock
en: Extra option(s) to pass to the format plugin. Specify each option in the 'name=value' format. See the documentation of each plugin for more information about the valid options and their meanings.
fr: Passe une ou des options supplémentaires au greffon de format. Spécifiez chaque option en utilisant le format S<« nom=valeur »>. Veuillez vous référer à la documentation de chaque greffon pour la liste des options valides et leurs significations.

note: type: textblock
en: Always generate the POT and PO files, even if po4a considers it is not necessary.
fr: Génère toujours les fichiers POT et PO, même si po4a considère que ce n'est pas nécessaire.

note: type: textblock
en: The default behavior (when --force is not specified) is the following:
fr: Le comportement par défaut (quand l'option --force n'est pas utilisée) est le S<suivant :>

note: type: textblock
en: If the POT file already exists, it is regenerated if a master document or the configuration file is more recent.  The POT file is also written in a temporary document and po4a verifies that the changes are really needed.
fr: Si le fichier POT existe déjà, il est regénéré si un document maître ou le fichier de configuration est plus récent. De plus, le fichier POT est écrit dans un document temporaire, et po4a vérifie que les modifications valent le coût.

note: type: textblock
en: Also, a translation is regenerated only if its master document, the PO file, one of its addenda or the configuration file is more recent.  To avoid trying to regenerate translations which do not pass the threshold test (see B<--keep>), a file with the '.po4a-stamp' extension can be created (see B<--stamp>).
fr: 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 « .po4a-stamp » peut être créé (voir l'option B<--stamp>).

note: type: textblock
en: If a master document includes files, you should use the B<--force> flag because the modification time of these included files are not taken into account.
fr: 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.

note: type: textblock
en: The PO files are always re-generated based on the POT with B<msgmerge -U>.
fr: Les fichiers PO sont toujours regénéré en fonction du POT avec B<msgmerge -U>.

note: type: textblock
en: Tells po4a to create stamp files when a translation is not generated because it does not reach the threshold. These stamp files are named according to the expected translated document, with the I<.po4a-stamp> extension.
fr: Indique à po4a de créer des fichiers d'horodatage quand une traduction n'a pas été générée par ce qu'elle ne dépasse pas le seuil de traduction. Ces fichiers d'horodatage sont nommés en ajoutant l'extension I<.po4a-stamp> au nom du fichier à générer.

note: type: textblock
en: Note: This only activates the creation of the I<.po4a-stamp> files. The stamp files are always used if they exist, and they are removed with B<--rm-translations> or when the file is finally translated.
fr: Note : Cette option ne concerne que la création des fichiers I<.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.

note: type: textblock
en: Do not generate the translated documents, only update the POT and PO files.
fr: Ne génère pas les documents traduits, ne met à jour que les fichiers POT et PO.

note: type: textblock
en: Remove the translated files (implies --no-translations).
fr: Supprime les documents traduits (implique --no-translations).

note: type: textblock
en: Do not generate the .po~ backup files.
fr: Ne génère pas les fichiers .po~ de sauvegarde.

note: type: textblock
en: Remove the .po~ backup files (implies --no-backups).
fr: Supprime les fichiers .po~ de sauvegarde (implique --no-backups).

note: type: =item
en: --translate-only I<translated-file>
fr: --translate-only I<fichier-traduit>

note: type: textblock
en: Translate only the specified file.  It may be useful to speed up processing if configuration file contains a lot of files.  Note that this option does not update PO and POT files.  This option can be used multiple times.
fr: 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.

note: type: =item
en: --variable I<var>=I<value>
fr: --variable I<var>=I<valeur>

note: type: textblock
en: Define a variable that will be expanded in the po4a configuration file.  Every occurrence of I<$(var)> will be replaced by I<value>.  This option can be used multiple times.
fr: Définit une variable dont toutes les occurrences seront remplacées dans le fichier de configuration de po4a. Les occurrences de I<$(var)> seront remplacées par I<valeur>. Cette option peut être utilisée plusieurs fois.

note: type: =item
en: --msgid-bugs-address email@address
fr: --msgid-bugs-address adresse@email

note: type: textblock
en: Set the report address for msgid bugs. By default, the created POT files have no Report-Msgid-Bugs-To fields.
fr: 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.

note: type: =item
en: --copyright-holder string
fr: --copyright-holder chaîne

note: type: textblock
en: Set the copyright holder in the POT header. The default value is "Free Software Foundation, Inc."
fr: Fixe le détenteur du copyright dans l'en-tête du fichier POT. La valeur par défaut est « Free Software Foundation, Inc. ».

note: type: =item
en: --package-name string
fr: --package-name chaîne

note: type: textblock
en: Set the package name for the POT header. The default is "PACKAGE".
fr: Fixe le nom du paquet pour l'en-tête du fichier POT. La valeur par défaut est « PACKAGE ».

note: type: =item
en: --package-version string
fr: --package-version chaîne

note: type: textblock
en: Set the package version for the POT header. The default is "VERSION".
fr: Fixe la version du paquet pour l'en-tête du fichier POT. La valeur par défaut est « VERSION ».

note: type: textblock
en: Extra options for msgmerge.
fr: Options additionnelles pour msgmerge.

note: type: textblock
en: Note: $lang will be extended to the current language.
fr: Note : $lang sera remplacé par la langue en cours.

note: type: textblock
en: This option removes '--previous' from the options passed to msgmerge.  This permits to support versions of gettext earlier than 0.16.
fr: Cette option supprime « --previous » des options passées à msgmerge. Elle premet de prendre en charge les versions de gettext antérieures à 0.16.

note: type: textblock
en: This option adds '--previous' to the options passed to msgmerge.  It requires gettext 0.16 or later, and is activated by default.
fr: Cette option ajoute « --previous » aux options passées à msgmerge. Elle nécessite une version 0.16 ou ultérieure de gettext et est activée par défaut.

note: type: =item
en: --srcdir I<SRCDIR>
fr: --srcdir I<RÉP_SRC>

note: type: textblock
en: Set the base directory for all input documents specified in the po4a configuration file.
fr: Définit le répertoire de base pour tous les documents d'entrée indiqués dans le fichier de configuration de po4a.

note: type: =item
en: --destdir I<DESTDIR>
fr: --destdir I<RÉP_DEST>

note: type: textblock
en: Set the base directory for all the output documents specified in the po4a configuration file.
fr: Définit le répertoire de base pour tous les documents de sortie indiqués dans le fichier de configuration de po4a.

note: type: textblock
en: Let's assume you maintain a program named B<foo> which has a man page F<man/foo.1> which naturally is maintained in English only. Now you as the upstream or downstream maintainer want to create and maintain the translation.  First you need to create the pot file necessary to send to translators using L<po4a-gettextize(1)>.
fr: 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 le développeur amont ou le 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)>.

note: type: textblock
en: So for our case we would call
fr: Ainsi dans notre cas, nous ferons

note: type: verbatim
en:  cd man && po4a-gettextize -f man -m foo.1 -p foo.pot
fr:  cd man && po4a-gettextize -f man -m truc.1 -p truc.pot

note: type: textblock
en: You would then send this file to the appropriate language lists or offer it for download somewhere on your website.
fr: Vous pourrez alors envoyer ce fichier aux listes de traductions adéquates ou le rendre disponible au téléchargement quelque part.

note: type: textblock
en: Now let's assume you received three translations before your next release: F<de.po> (including an addendum F<de.add>), F<sv.po> and F<pt.po>.  Since you don't want to change your makefile(s) whenever a new translation arrives you can use po4a with an appropriate configuration file in your makefile.  Let's call it F<po4a.cfg>. In our example it would look like the following:
fr: Considérons maintenant que vous receviez trois traductions avant la prochaine 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 Makefile à chaque nouvelle traduction reçue, vous pouvez utiliser po4a avec le fichier de configuration adéquat dans chaque Makefile. Ce fichier de configuration peut s'appeler F<po4a.cfg>, dans cet exemple, il ressemblerait à :

note: type: verbatim
en:  [type: man] foo.1 $lang:man/foo.$lang.1 \
                add_$lang:?man/foo.$lang.add opt:"-k 80"
fr:  [type: man] truc.1 $lang:man/truc.$lang.1 \
                add_$lang:?man/$lang.add opt:"-k 80"

note: type: textblock
en: In this example we assume that your generated man pages (and all po and add files) should be stored in F<man/> below the current directory. In our example this directory would include F<de.po>, F<de.add>, F<pt.po> and F<sv.po>.
fr: 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/> à l'intérieur du répertoire en cours. Ici ce répertoire contiendrait F<de.po>, F<de.add>, F<pt.po> et F<sv.po>.

note: type: textblock
en: Note the use of the modifier '?' as only the German translation (F<de.po>) is accompanied by an addendum.
fr: Remarquez l'utilisation du modificateur « ? » car seule la traduction allemande (F<de.po>) est accompagnée d'un addendum.

note: type: textblock
en: To actually build the translated man pages you would then (once!) add the following line in the build target of the appropriate makefile:
fr: Pour vraiment construire les pages de manuel traduites, vous devrez alors (une seule fois) ajouter la ligne suivante dans la cible build du Makefile adéquat :

note: type: textblock
en: Once this is set up you don't need to touch the makefile when a new translation arrives, i.e. if the French team sends you F<fr.po> and F<fr.add> then you simply drop it in F<man/> and the next time the programm is build the French translation is automatically build as well.
fr: Une fois configuré, il ne sera plus nécessaire de modifier le 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 dans F<man/> et la prochaine fois que le programme sera construit, la traduction française sera aussi automatiquement construite.

note: type: textblock
en: Note that you still need an appropriate target to install localized manual pages with English ones.
fr: Notez que vous avez toujours besoin d'une cible adéquate pour installer les pages de manuels traduites en plus de celles en anglais.

note: type: verbatim
en: Finally if you do not store generated files into your version control system,
    you will need a line in your clean target as well:
            -rm -f man/foo.*.1
            -rm -f man/foo.pot
fr: Enfin, si vous ne voulez pas garder les fichiers dans le système de gestion de version,
    vous devriez aussi ajouter ces lignes à la cible clean :
            -rm -f man/truc.*.1
            -rm -f man/truc.pot

note: type: textblock
en: Duplicates some code with the po4a-* programs.
fr: Duplique du code des autres programmes de la suite po4a.

note: type: textblock
en: Patch welcome ;)
fr: Toute rustine est la bien S<venue ;)>

note: type: textblock
en: Copyright 2002-2010 by SPI, inc.
fr: Copyright 2002-2010 par SPI, inc.

note: type: textblock
en: This program is free software; you may redistribute it and/or modify it under the terms of GPL (see the COPYING file).
fr: 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).

note: type: textblock
en: po4a-gettextize - convert an original file (and its translation) to a po file
fr: po4a-gettextize - convertit un fichier original (et sa traduction) en fichier PO

note: type: textblock
en: po4a-gettextize -f E<lt>fmtE<gt> -m E<lt>master.docE<gt> [-l E<lt>XX.docE<gt>] -p E<lt>XX.poE<gt>
fr: po4a-gettextize -f E<lt>formatE<gt> -m E<lt>maitre.docE<gt> [-l E<lt>XX.docE<gt>] -p E<lt>XX.poE<gt>

note: type: textblock
en: (XX.po is the output, all others are inputs)
fr: (XX.doc est le fichier de sortie, tous les autres sont des entrées)

note: type: textblock
en: The C<po4a-gettextize> script is in charge of converting documentation files to po files.  If you start a new translation, C<po4a-gettextize> will extract the translatable strings from the documentation file and write a pot file from it.
fr: Le script C<po4a-gettextize> sert à convertir des fichiers de documentation depuis leur format d'origine vers le format PO. Si vous débutez une nouvelle traduction, C<po4a-gettextize> extraira du fichier de documentation les chaînes devant être traduites et les écrira dans un fichier POT.

note: type: textblock
en: If you already have a translated file, C<po4a-gettextize> will try to extract the translations it contains and put them in place in the written po file. Be warned that very few intelligence is used in this process: the Nth string of the translated file is supposed to be the translation of the Nth string in the original. If it's not the case, you're dead. That's why it is very important that both files share exactly the same structure.
fr: Si vous disposez d'ores et déjà d'une traduction dans le même format que l'original, C<po4a-gettextize> va essayer d'en extraire le contenu pour le placer comme traduction dans le fichier PO. Attention, C<po4a-gettextize> ne remplit pas cette tâche très S<intelligemment :> il suppose que la énième chaîne du fichier traduit est la traduction de la énième chaîne du fichier original. Si ce n'est pas le cas, vous êtes mort. C'est pourquoi il est très important que les deux fichiers aient exactement la même structure.

note: type: textblock
en: However, C<po4a-gettextize> will diagnose your death by detecting any desynchronisation between files, and reporting where they occur. In that case, you should edit manually the files to solve the reported disparity. Even if no error were reported, you should check carefully that the generated po file is correct (ie, that each msgstr is the translation of the associated msgid, and not the one before or after).
fr: Cependant, C<po4a-gettextize> détectera sans doute toute désynchronisation entre les fichiers. Si le cas se produit, vous devez éditer les fichiers manuellement afin de corriger le problème. Même si aucune erreur n'a été signalée, vous devriez soigneusement vérifier que le fichier PO généré est valide (c'est-à-dire que chaque msgstr est bien la traduction du msgid auquel il est associé, et non du précédent ou du suivant).

note: type: textblock
en: Even if the script manages to do its job without any apparent problem, it still marks all extracted translations as fuzzy, to make sure that the translator will have a look at them, and detect any remaining problem.
fr: Même si le script parvient à remplir sa tâche sans problème apparent, il marque toutes les chaînes extraites comme S<« fuzzy »> (approximatives), pour s'assurer que le traducteur les vérifiera et détectera les éventuels problèmes restants.

note: type: textblock
en: If the master document has non-ascii characters, the new generated po file will be in utf-8, in order to allow non-standard characters in a culture independent way. Else (if the master document is completely in ascii), the generated po will use the encoding of the translated input document.
fr: Si le document maître contient des caractères non ASCII, il convertit les fichiers PO en UTF-8 (si ce n'est pas déjà le cas), de façon à autoriser les caractères non standard en fonction des paramètres régionaux. Sinon (si le document maître ne contient que des caractères ASCII), le fichier PO généré utilisera l'encodage du document traduit donné en entrée.

note: type: textblock
en: Format of the documentation you want to handle. Use the --help-format option to see the list of available formats.
fr: Type de format de la documentation que vous souhaitez traiter. Utilisez l'option --help-format pour afficher la liste des formats disponibles.

note: type: textblock
en: File containing the master document to translate. You can use this option multiple times if you want to gettextize multiple documents.
fr: Fichier contenant le document maître à traduire. Vous pouvez utiliser cette option plusieurs fois si vous voulez gettextizer plusieurs documents.

note: type: textblock
en: Charset of the file containing the document to translate.
fr: Jeu de caractères du fichier contenant les documents à traduire.

note: type: textblock
en: File containing the localized (translated) document. If you provided multiple master files, you may wish to provide multiple localized file by using this option more than once.
fr: Fichier contenant le document traduit. Si vous fournissez plusieurs fichiers maîtres, vous voudrez sûrement fournir également plusieurs documents traduits en utilisant cette option plusieurs fois.

note: type: textblock
en: Charset of the file containing the localized document.
fr: Jeu de caractères du fichier contenant le document traduit.

note: type: textblock
en: File where the message catalog should be written. If not given, the message catalog will be written to the standard output.
fr: Fichier où le catalogue de messages sera écrit. S'il n'est pas spécifié, le catalogue de messages sera écrit sur la sortie standard.

note: type: textblock
en: List the documentation format understood by po4a.
fr: Énumère les formats de documentations connus de po4a.

note: type: textblock
en: po4a-normalize - normalize a documentation file by parsing it in po4a, and writing it back
fr: po4a-normalize - Normalise un fichier de documentation en le faisant analyser puis réécrire par po4a

note: type: textblock
en: po4a-normalize -f E<lt>fmtE<gt> E<lt>master.docE<gt>
fr: po4a-normalize -f E<lt>formatE<gt> E<lt>maitre.docE<gt>

note: type: textblock
en: The C<po4a-normalize> script is a debugging tool used to make sure that po4a don't change the document when it's not supposed to. Only use it if you're developing a new module, or if you doubt the sanity of the tools.
fr: Le script C<po4a-normalize> est un outil de débogage permettant de s'assurer que po4a ne modifie pas les documents plus que de raison. Il ne devrait être utile que lors du développement d'un nouveau module ou si vous doutez de la qualité d'un module.

note: type: textblock
en: The generated document will be written to po4a-normalize.output while the generated po file will be written to po4a-normalize.po. No way to change that ;)
fr: Le document généré est écrit dans po4a-normalize.output tandis que le fichier PO généré est écrit dans po4a-normalize.po. Impossible de changer S<ça ;)>

note: type: textblock
en: Create an blank translated document.  The generated translated document will be generated assuming all messages are translated by a space or new line.
fr: Crée une traduction «  blanche » du document. Le document traduit généré sera généré en supposant que tous les messages sont traduits en une espace ou une nouvelle ligne.

note: type: textblock
en: This is useful to check what parts of the document cannot be translated.
fr: C'est utile pour vérifier les parties d'un document qui ne peuvent pas être traduites.

note: type: textblock
en: po4a-translate - convert a po file back to documentation format
fr: po4a-translate - reconvertit un fichier PO en fichier de documentation

note: type: textblock
en: po4a-translate -f E<lt>fmtE<gt> -m E<lt>master.docE<gt> -p E<lt>XX.poE<gt> -l E<lt>XX.docE<gt>
fr: po4a-translate -f E<lt>formatE<gt> -m E<lt>maitre.docE<gt> -p E<lt>XX.poE<gt> -l E<lt>XX.docE<gt>

note: type: textblock
en: (XX.doc is the output, all others are inputs)
fr: (XX.doc est le fichier de sortie, les autres sont des entrées)

note: type: textblock
en: The C<po4a-translate> script is in charge of converting the translation (which was done in a po file) under the documentation format back. The provided C<po> file should be the translation of the C<pot> file which were produced by po4a-gettextize(1).
fr: Le script C<po4a-translate> sert à reconvertir la traduction (faite dans un fichier PO) dans le format d'origine. Le fichier C<PO> fourni devrait être la traduction du fichier C<POT> produit par po4a-gettextize(1).

note: type: textblock
en: Add a file to the resulting file (to put translator's name or a section "About this translation", for example). The first line of the file to insert should be a PO4A header indicating where it should be added (see section I<HOWTO add extra text to translations> in po4a(7)).
fr: Ajoute le contenu d'un fichier dans le résultat (pour ajouter le nom du traducteur 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 I<Comment ajouter des choses n'étant pas des traductions> dans po4a(7)).

note: type: textblock
en: File containing the master document to translate.
fr: Fichier contenant les documents maîtres à traduire.

note: type: textblock
en: File where the localized (translated) document should be written.
fr: Fichier où sera écrit le document traduit.

note: type: textblock
en: File from which the message catalog should be read.
fr: Fichier contenant le catalogue de messages à lire.

note: type: textblock
en: Column at which we should wrap the resulting file.
fr: Nombre de colonnes dans le fichier de sortie.

note: type: =head1
en: Adding content (beside translations) to generated files
fr: Ajouter du contenu (en plus de la traduction) aux fichiers générés

note: type: textblock
en: To add some extra content to the generated document beside what you translated (like the name of the translator, or a "about this translation" section), you should use the C<--addendum> option.
fr: Pour ajouter du contenu autre que la traduction aux fichiers générés (comme le nom du traducteur ou une section à propos de la traduction), vous devez utiliser l'option C<--addendum>.

note: type: textblock
en: The first line of the addendum must be a header indicating where to put it in the document (it can be before or after a given part of the document).  The rest of the file will be added verbatim to the resulting file without further processing.
fr: 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é.

note: type: textblock
en: Note that if po4a-translate fails to add one of the given files, it discards the whole translation (because the missing file could be the one indicating the author, what would prevent the users to contact him to report bugs in the translation).
fr: Remarquez que si l'ajout de l'un des fichiers échoue, la traduction complète est abandonnée (car le fichier manquant peut être celui indiquant le nom de l'auteur, ce qui empêcherait les utilisateurs de le contacter pour lui signaler des erreurs de traduction)

note: type: textblock
en: The header has a pretty rigid syntax. For more information on how to use this feature and how it works, please refer to the po4a(7) man page.
fr: Les en-têtes ont une syntaxe relativement rigide. Pour plus d'informations à ce sujet, veuillez vous reporter à la page de manuel po4a(7).

note: type: textblock
en: po4a-updatepo - update the translation (in po format) of documentation
fr: po4a-updatepo - met la traduction (au format PO) de la documentation à jour.

note: type: textblock
en: po4a-updatepo -f E<lt>fmtE<gt> (-m E<lt>master.docE<gt>)+ (-p E<lt>XX.poE<gt>)+
fr: po4a-updatepo -f E<lt>formatE<gt> (-m E<lt>maitre.docE<gt>)+ (-p E<lt>XX.poE<gt>)+

note: type: textblock
en: (XX.po are the outputs, all others are inputs)
fr: (XX.po sont les fichiers de sortie, tous les autres sont des entrées)

note: type: textblock
en: The C<po4a-updatepo> script is in charge of updating po files to make them reflect the changes made to the original documentation file. For that, it converts the documentation file to a pot file, and call L<msgmerge(1)> on this new pot and on the provided po files.
fr: Le script C<po4a-updatepo> met à jour un fichier PO afin qu'il reflète les changements apportés au fichier original. Pour cela, il convertit le fichier POD en fichier POT, puis invoque L<msgmerge(1)> sur ce nouveau POT et sur les fichiers PO fournis.

note: type: textblock
en: It is possible to give more than one po file (if you want to update several languages at once), and several documentation files (if you want to store the translations of several documents in the same po file).
fr: Il est possible de donner plus d'un fichier PO à la fois (si vous voulez mettre plusieurs langues à jour d'un coup), et plusieurs fichiers de documentation (si vous voulez stocker la traduction de plusieurs documents dans le même fichier PO)

note: type: textblock
en: If the master document has non-ascii characters, it will convert the po files to utf-8 (if they weren't already), in order to allow non-standard characters in a culture independent way.
fr: Si le document maître contient des caractères non ASCII, il convertit les fichiers po en UTF-8 (si ce n'est pas déjà le cas), de façon à autoriser les caractères non standard en fonction des paramètres régionaux.

note: type: =head1
en: COMMAND-LINE OPTIONS
fr: OPTIONS EN LIGNE DE COMMANDE

note: type: textblock
en: File(s) containing the master document to translate.
fr: Fichier(s) contenant les documents maîtres à traduire.

note: type: textblock
en: Charset of the files containing the document to translate. Note that all files must have the same charset.
fr: Jeu de caractères des fichiers contenant les documents à traduire. Notez que tous les fichiers doivent partager le même jeu de caractères.

note: type: textblock
en: Po file(s) to update. If these files do not exist, they are created by C<po4a-updatepo>.
fr: Fichier(s) PO à mettre à jour. Si ces fichiers n'existent pas, ils sont créés par C<po4a-updatepo>.

note: type: textblock
en: Extra option(s) to pass to the format plugin and other po4a internal module.  Specify each option in the 'name=value' format. See the documentation of each plugin for more information about the valid options and their meanings.
fr: Passe une ou des options supplémentaires au greffon de format. Spécifiez chaque option en utilisant le format S<« nom=valeur »>. Veuillez vous référer à la documentation de chaque greffon pour la liste des options valides et leur signification.

note: type: textblock
en: List the documentation format handled by po4a.
fr: Liste les formats de documentation connus de po4a.

note: type: textblock
en: msguntypot - update po files when a typo is fixed in pot file
fr: msguntypot - Mettre à jour des fichiers PO quand une typo est corrigée dans un fichier POT

note: type: textblock
en: msguntypot -o E<lt>old_potE<gt> -n E<lt>new_potE<gt> pofiles...
fr: msguntypot -o E<lt>ancien_pot<gt> -n E<lt>nouveau_pot<gt> fichier_po...

note: type: textblock
en: When you fix a trivial error which surely doesn't affect translations (e.g.  a typo) in a .pot file, you should unfuzzy the corresponding msgstr in the translated .po files to avoid so extra work to the translators.
fr: Lorsque vous corrigez une erreur triviale qui n'affectera pas les traductions (par exemple une faute d'orthographe) dans un fichier POT, vous devriez retirer l'étiquette fuzzy sur les msgstr correspondantes dans les fichier PO afin d'éviter du travail supplémentaire aux traducteurs.

note: type: textblock
en: This task is difficult and error prone when done manually, and this tool is there to help doing so correctly. You just need to provide the two versions of the pot file: before the edition and after as marked in the above synopsis, and it all becomes automatic.
fr: Cette tâche est difficile et peut générer des erreurs quand elle est faite manuellement. Cet outil est là pour vous aider à faire ceci correctement. Vous n'avez qu'à fournir les deux versions du fichier S<POT :> avant la correction et après, comme indiqué dans la synopsis ci-dessus. Tout le reste est fait automatiquement.

note: type: =head1
en: HOW TO USE IT
fr: COMMENT L'UTILISER

note: type: textblock
en: In short, when you discover a typo in one of your [english] message, do the following:
fr: En bref, quand vous découvrez une erreur dans un de vos message (en anglais), faites comme S<suit :>

note: type: =item
en: - Regenerate your pot and po files.
fr: - Regénérez vos fichiers POT et PO.

note: type: verbatim
en:   make -C po/ update-po # for message program translations
      debconf-updatepo      # for debconf translations
      po4a po4a.conf        # for po4a based documentation translations
fr:   make -C po/ update-po # pour les traductions des messages d'un programme
      debconf-updatepo      # pour les traductions debconf
      po4a po4a.conf        # pour les traductions de documentation
                            # utilisant po4a

note: type: textblock
en: or something else, depending on your project's building settings. You know how to make sure your pot an po files are uptodate, don't you??
fr: ou quelque chose d'autre en fonction de votre projet. Vous savez comment mettre à jour vos fichiers POT et PO, n'est-ce S<pas ?>

note: type: =item
en: - Make a copy of your pot file.
fr: - Faites une copie de votre fichier POT.

note: type: verbatim
en:   cp myfile.pot myfile.pot.orig
fr:   cp monfichier.pot monfichier.pot.orig

note: type: =item
en: - Make a copy of all your files.
fr: - Faites une copie de tous vos fichiers.

note: type: verbatim
en:   mkdir po_fridge; cp *.po po_fridge
fr:   mkdir po_orig; cp *.po po_orig

note: type: =item
en: - Fix your typo
fr: - Corrigez l'erreur.

note: type: textblock
en: $EDITOR the_file_in_which_there_is_a_typo
fr: $EDITOR le_fichier_à_corriger

note: type: textblock
en: See above.
fr: Voir ci-dessus

note: type: textblock
en: At this point, the typo fix fuzzied all the translations, and this unfortunate change is the only one between the po files of your main directory and the one from the fridge. Here is how to solve this.
fr: À ce moment là, la correction a marqué certaines chaînes fuzzy, et c'est malheureusement la seule modification entre les fichiers PO de votre répertoire et ceux de po_orig. Voici comment corriger cela.

note: type: =item
en: - Discard fuzzy translation, restore the ones from the fridge.
fr: - Abandonner les traductions fuzzy, récupérer celles du répertoire originel.

note: type: verbatim
en:   cp po_fridge/*.po .
fr:   cp po_orig/*.po .

note: type: =item
en: - Manually merge the po files with the new pot file, but taking the useless fuzzy into account
fr: - Fusionner manuellement les fichiers PO avec le nouveau fichier POT, en prenant en compte le fait que les étiquettes fuzzy sont inutiles.

note: type: verbatim
en:   msguntypot -o myfile.pot.orig -n myfile.pot *.po
fr:   msguntypot -o monfichier.pot.orig -n monfichier.pot *.po

note: type: =item
en: - Cleanups.
fr: - Nettoyages.

note: type: verbatim
en:   rm -rf myfile.pot.orig po_fridge
fr:   rm -rf monfichier.pot.orig po_orig

note: type: textblock
en: You're done. The typo was eradicated from msgstr of both your pot and po files, and the po files were not fuzzyied in the process. Your translators love you already.
fr: C'est fini. L'erreur a été supprimée des messages de vos fichiers POT et PO, et les fichiers PO n'ont pas été fuzzyfiés au passage. Vous êtes désormais aimé(e) de vos traducteurs.

note: type: textblock
en: Despite its name, this tool is not part of the gettext tool suite. It is instead part of po4a. More precisely, it's a random perl script using the fine po4a modules. For more information about po4a, please see:
fr: Contrairement à ce que son nom indique, cet outil ne fait pas partie de la suite d'outils gettext. Il fait partie de po4a. Plus précisément, il s'agit d'un script utilisant les modules de po4a. Pour plus d'informations sur po4a, veuillez S<consulter :>

note: type: verbatim
en:  Martin Quinson (mquinson#debian,org)
fr:  Martin Quinson (mquinson#debian.org)

note: type: textblock
en: Copyright 2005 by SPI, inc.
fr: Copyright 2005 par SPI, inc.

note: type: textblock
en: po4a-build.conf - configuration file for building translated content
fr: po4a-build.conf - fichier de configuration pour la construction des contenus
