.\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` «\ 
.    ds C' \ »
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "PO-DEBCONF 7"
.TH PO-DEBCONF 7 "2018-11-20" "" "po-debconf"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NOM"
.IX Header "NOM"
po-debconf \- Introduction
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
L'objectif de \f(CW\*(C`debconf\*(C'\fR était de rendre la configuration de paquets
conviviale. Afin d'arriver à ce but, il est important de s'assurer que les
utilisateurs lisent les questions dans leur propre langue. Les traducteurs
ont besoin d'une infrastructure qui leur permette de travailler facilement
sur des traductions sans avoir besoin de suivre à la trace le développement
du programme ; \f(CW\*(C`po\-debconf\*(C'\fR a été conçu pour travailler avec les
outils habituels de \f(CW\*(C`gettext\*(C'\fR pour traduire les questionnaires debconf.
.SH "AJOUTER LA GESTION I18N POUR LES QUESTIONNAIRES DEBCONF"
.IX Header "AJOUTER LA GESTION I18N POUR LES QUESTIONNAIRES DEBCONF"
Si vous utilisez debconf avec votre paquet, vous avez écrit un fichier
questionnaire en anglais. Pour ajouter la gestion i18n à votre paquet, vous
devez :
.IP "\- créer le fichier \fIdebian/po/POTFILES.in\fR" 4
.IX Item "- créer le fichier debian/po/POTFILES.in"
Ce fichier contient la liste des questionnaires maîtres, qui n'est souvent
composé que d'une seule ligne :
.Sp
.Vb 1
\&  [type: gettext/rfc822deb] templates
.Ve
.Sp
Les chemins sont relatifs au répertoire parent.
.IP "\- ajouter un caractère souligné devant les champs traduisibles dans chaque questionnaire." 4
.IX Item "- ajouter un caractère souligné devant les champs traduisibles dans chaque questionnaire."
Normalement, les champs \f(CW\*(C`Description\*(C'\fR, \f(CW\*(C`Choices\*(C'\fR et parfois \f(CW\*(C`Default\*(C'\fR
peuvent être traduits.
.IP "\- exécuter \fBdebconf-updatepo\fR" 4
.IX Item "- exécuter debconf-updatepo"
Ceci créera le fichier \fIdebian/po/templates.pot\fR que les traducteurs
traduiront dans leur langue.
.ie n .IP "\- ajouter une dépendance de construction sur ""po\-debconf"" dans \fIdebian/control\fR" 4
.el .IP "\- ajouter une dépendance de construction sur \f(CWpo\-debconf\fR dans \fIdebian/control\fR" 4
.IX Item "- ajouter une dépendance de construction sur po-debconf dans debian/control"
.SH "METTRE À JOUR DES MODÈLES"
.IX Header "METTRE À JOUR DES MODÈLES"
Afin d'aider les traducteurs, vous devez faire en sorte que les fichiers \s-1PO\s0
soient constamment à jour, sinon ils risquent de traduire des chaînes qui ne
sont plus utilisées. Pour cela, appelez simplement la commande suivante sans
paramètre :
.PP
.Vb 1
\&  $ debconf\-updatepo
.Ve
.PP
Cette commande doit être exécutée à chaque changement dans les chaînes en
anglais, mais aussi lorsque vous recevez de nouvelles traductions ou des
mises à jour, car le traducteur peut avoir traduit un fichier \s-1PO\s0 obsolète.
.PP
Si vous renommez, ajoutez ou supprimez des fichiers questionnaires, pensez
aussi à modifier le fichier \fIdebian/po/POTFILES.in\fR en conséquence, sinon
les chaînes de ces fichiers n'apparaîtront pas dans les fichiers \s-1PO\s0 et
seront affichées en anglais, alors que le fichier \s-1PO\s0 peut être complètement
traduit.
.PP
Le programme \fBdebconf-updatepo\fR ne modifie les fichiers \s-1PO\s0 que si leur
contenu a été altéré. Ainsi, la meilleure solution pour fournir des fichiers
\&\s-1PO\s0 à jour dans un paquet source consiste à exécuter cette commande depuis la
règle \f(CW\*(C`clean\*(C'\fR du fichier \fIdebian/rules\fR.
.PP
Il est important de savoir que \fBdebconf-updatepo\fR doit être exécuté même si
vous utilisez la commande \fBdh_installdebconf\fR. Celle-ci exécute
\&\fBpo2debconf\fR qui, auparavant, appelait \fBdebconf-updatepo\fR si des fichiers
obsolètes étaient détectés, mais ce n'est plus le cas parce que ce n'était
pas une solution satisfaisante pour au moins deux raisons :
.IP "1." 3
\&\fBpo2debconf\fR utilisait la date des fichiers enregistrés sur le disque pour
détecter les fichiers obsolètes, ce qui n'est pas fiable si on utilise
\&\f(CW\*(C`pbuilder\*(C'\fR ou si une traduction obsolète a été enregistrée sur le disque
après modification de l'original ;
.IP "2." 3
\&\fBdh_installdebconf\fR est exécuté bien après que le fichier \f(CW\*(C`.diff.gz\*(C'\fR a été
écrit ;
.SH "FUSIONNER DES TRADUCTIONS ET L'ORIGINAL"
.IX Header "FUSIONNER DES TRADUCTIONS ET L'ORIGINAL"
Vous devez vous assurer que, lors de la compilation de votre paquet, les
traductions sont placées dans le paquet construit. Vous pouvez le faire
vous\-même, ou automatiquement en utilisant le script \fBdh_installdebconf\fR
(assurez-vous d'avoir une dépendance de construction avec un numéro de
version sur \f(CW\*(C`debhelper (>= 4.1.16)\*(C'\fR).
.PP
Pour le faire vous\-même, vous devez fusionner le questionnaire et les
traductions lors de la compilation (et avoir une dépendance de construction
sur \f(CW\*(C`po\-debconf\*(C'\fR) de cette manière :
.PP
.Vb 1
\&  $ po2debconf debian/templates > debian/tmp/DEBIAN/templates
.Ve
.PP
\&\fB\s-1ATTENTION\s0\fR : Les deux fichiers appelés \fItemplates\fR ne sont pas les
mêmes du tout. Le premier ne contient que le texte en anglais, avec des
marques pour indiquer les champs à traduire, alors que le second contient
toutes les traductions. Cela signifie que vous \s-1NE POUVEZ PAS\s0 conserver
uniquement les questionnaires fusionnés, ou alors vous ne pourrez plus gérer
les traductions qui vous seront soumises.
.SH "NOUVEAUX MODÈLES MAÎTRES"
.IX Header "NOUVEAUX MODÈLES MAÎTRES"
Le nouveau format source de fichier de questionnaires est pratiquement
identique à celui des fichiers de questionnaires distribués, seul un
souligné est ajouté devant les champs à traduire. Par exemple :
.PP
.Vb 10
\&  Template: debconf/frontend
\&  Type: select
\&  _Choices: Dialog, Readline, Gnome, Editor, Noninteractive
\&  Default: Dialog
\&  _Description: Interface to use for configuring packages:
\&   Packages that use debconf for configuration share a common look and
\&   feel.  You can select the type of user interface they use.
\&   .
\&   The dialog frontend is a full\-screen, character based interface,
\&   while the readline frontend uses a more traditional plain text
\&   interface, and the gnome frontend is a modern X interface.  The
\&   editor frontend lets you configure things using your favorite text
\&   editor. The noninteractive frontend never asks you any questions.
.Ve
.SS "DÉCOUPER \s-1LA LISTE DES CHOIX\s0"
.IX Subsection "DÉCOUPER LA LISTE DES CHOIX"
À partir de la version 0.6.0 de \f(CW\*(C`po\-debconf\*(C'\fR, les champs à traduire peuvent
contenir deux soulignés. Dans ce cas, le champ est supposé contenir une
liste de valeurs séparées par des virgules, elles seront placées dans des
champs \fImsgid\fR différents. Ainsi si l'exemple précédent contenait :
.PP
.Vb 1
\&  _\|_Choices: Dialog, Readline, Gnome, Editor, Noninteractive
.Ve
.PP
cinq champs \fImsgid\fR différents auraient été créés. Veuillez noter que les
espaces après les virgules ne sont pas pris en compte.
.PP
Lorsqu'une liste de choix ne change jamais, \f(CW\*(C`_Choices\*(C'\fR peut être considéré
comme adapté. Cependant, l'éclatement de ces listes permet d'éviter des
erreurs fréquentes dans les traductions, notamment l'oubli d'un choix et
l'utilisation de virgules non standard. Pour ces raisons, l'utilisation de
\&\f(CW\*(C`_\|_Choices\*(C'\fR facilitera le travail des traducteurs et est fortement
recommandée.
.PP
Malheureusement si vous décidez de basculer entre ces deux formes, toutes
les traductions sont marquées \f(CW\*(C`fuzzy\*(C'\fR. C'est une justification pour
effectuer ce changement sans perdre de traduction (ceci requiert
\&\f(CW\*(C`po\-debconf\*(C'\fR >= 1.0). Supposez que vous voulez basculer l'exemple
précédent vers \f(CW\*(C`_\|_Choices\*(C'\fR. Vous copiez le fichier \fItemplates\fR dans un
fichier temporaire :
.PP
.Vb 1
\&  $ cp debian/templates debian/foo
.Ve
.PP
Éditez \fIdebian/foo\fR et ne garder seulement que les champs \f(CW\*(C`Template\*(C'\fR,
\&\f(CW\*(C`Type\*(C'\fR et \f(CW\*(C`_Choices\*(C'\fR de cet exemple :
.PP
.Vb 3
\&  Template: debconf/frontend
\&  Type: select
\&  _Choices: Dialog, Readline, Gnome, Kde, Editor, Noninteractive
.Ve
.PP
Exécutez \fBdebconf-gettextize\fR avec les options \f(CW\*(C`\-\-merge\*(C'\fR et \f(CW\*(C`\-\-choices\*(C'\fR
pour construire les fichiers \s-1PO :\s0
.PP
.Vb 1
\&  $ debconf\-gettextize \-\-merge \-\-choices debian/foo
.Ve
.PP
Ensuite vous devez supprimer \fIfoo\fR et éditer vous\-même \fIdebian/templates\fR
pour modifier \f(CW\*(C`_Choices\*(C'\fR en \f(CW\*(C`_\|_Choices\*(C'\fR avant d'exécuter
\&\fBdebconf-updatepo\fR.
.SS "\s-1AJOUTER DES COMMENTAIRES POUR LES TRADUCTEURS\s0"
.IX Subsection "AJOUTER DES COMMENTAIRES POUR LES TRADUCTEURS"
Les responsables de \f(CW\*(C`dpkg\*(C'\fR ont décidé que, par convention, les lignes dans
les fichiers \fIdebian/control\fR qui commencent par un symbole dièse sont des
commentaires et \f(CW\*(C`po\-debconf\*(C'\fR suit cette règle. Depuis
\&\f(CW\*(C`po\-debconf\*(C'\fR 0.8.0, de tels commentaires sont automatiquement écrits
dans les fichiers \s-1PO\s0 et peuvent donc contenir des informations qui
intéressent les traducteurs. Heureuse coïncidence, toutes les versions
précédentes de \f(CW\*(C`po\-debconf\*(C'\fR ignorent les lignes ne contenant pas de symbole
deux-points ; si vos commentaires ne contiennent pas ce symbole, ce
n'est donc pas la peine d'ajouter une dépendance de construction sur une
version récente de \f(CW\*(C`po\-debconf\*(C'\fR. Voici un exemple d'utilisation :
.PP
.Vb 4
\&  Template: debconf/button\-yes
\&  Type: text
\&  # Translators, this text will appear on a button, so KEEP IT SHORT
\&  _Description: Yes
.Ve
.PP
Des commentaires spéciaux ont été introduits dans \f(CW\*(C`po\-debconf\*(C'\fR 1.0
pour traiter les chaînes de caractères composées de plusieurs choix (les
champs \fIChoices\fR) ou paragraphes (les champs \fIDescription\fR). Avec ces
directives, les développeurs ont un meilleur contrôle sur ce qui est exposé
aux traducteurs. Les directives sont de la forme
\&\f(CW\*(C`#flag:\f(CIdirective\f(CW\*(C'\fR ; elles sont détaillées ci-dessous :
.IP "\fBtranslate:\fR\fIspec\fR, \fBtranslate!:\fR\fIspec\fR" 3
.IX Item "translate:spec, translate!:spec"
Ne marquez que quelques éléments comme traduisibles ; \fIspec\fR est une
liste de nombres séparés par des virgules, elle indique quelles chaînes
seront imprimées dans le fichier \s-1PO.\s0 Des intervalles peuvent aussi être
définis avec un signe moins (par exemple, \f(CW\*(C`2\-6\*(C'\fR) et une étoile (\f(CW\*(C`*\*(C'\fR)
signifie toutes les chaînes. Par exemple, avec :
.Sp
.Vb 5
\&  Template: partman\-basicfilesystems/fat_mountpoint
\&  Type: select
\&  #flag:translate:3,4
\&  _\|_Choices: /dos, /windows, Enter manually, Do not mount it
\&  _Description: Mount point for this partition:
.Ve
.Sp
\&\f(CW\*(C`Enter manually\*(C'\fR et \f(CW\*(C`Do not mount it\*(C'\fR apparaîtront dans les fichiers \s-1PO\s0
mais pas \f(CW\*(C`/dos\*(C'\fR et \f(CW\*(C`/windows\*(C'\fR. Quand un point d'exclamation suit le mot
clé \fBtranslate\fR, \fIspec\fR indique quelles chaînes seront écartées des
fichiers \s-1PO,\s0 toutes les autres chaînes étant enregistrées. L'exemple
précédent est identique à :
.Sp
.Vb 5
\&  Template: partman\-basicfilesystems/fat_mountpoint
\&  Type: select
\&  #flag:translate!:1,2
\&  _\|_Choices: /dos, /windows, Enter manually, Do not mount it
\&  _Description: Mount point for this partition:
.Ve
.Sp
Le même mot clé peut être aussi appliqué au champ \fIDescription\fR pour être
sûr que certaines chaînes ne seront pas traduites.
.Sp
.Vb 8
\&  Template: partman\-crypto/options_missing
\&  Type: error
\&  #flag:translate!:3
\&  _Description: Required encryption options missing
\&   The encryption options for ${DEVICE} are incomplete. Please
\&   return to the partition menu and select all required options.
\&   .
\&   ${ITEMS}
.Ve
.Sp
Mais ceci est hasardeux car le contexte peut être perdu depuis les fichiers
\&\s-1PO.\s0 Ajoutez des commentaires dans ce cas pour ne pas induire le traducteur
en erreur.
.IP "\fBcomment:\fR\fIspec\fR, \fBcomment!:\fR\fIspec\fR" 3
.IX Item "comment:spec, comment!:spec"
Ce commentaire juste en-dessous de cette directive s'applique aux chaînes
indiquées par \fIspec\fR qui est défini au-dessus. Par défaut, un commentaire
écrit avant un champ traduisible est affiché pour toutes les chaînes
appartenant à ce champ. (Note : avec \f(CW\*(C`po\-debconf\*(C'\fR < 1.0, le
commentaire n'est écrit qu'avec la première chaîne.)
.Sp
.Vb 10
\&  Template: arcboot\-installer/prom\-variables
\&  Type: note
\&  # Translators, the 4th string of this description has been dropped
\&  # from PO files.  It contains shell commands and should not be
\&  # translated.
\&  #flag:comment:3
\&  # "Stop for Maintenance" should be left in English
\&  #flag:translate!:4
\&  _Description: Setting PROM variables for Arcboot
\&   If this is the first Linux installation on this machine, or if the
\&   hard drives have been repartitioned, some variables need to be set
\&   in the PROM before the system is able to boot normally.
\&   .
\&   At the end of this installation stage, the system will reboot.
\&   After this, enter the command monitor from the "Stop for
\&   Maintenance" option, and enter the following commands:
\&   .
\&      setenv OSLoader arcboot
\&      setenv OSLoadFilename Linux
\&   .
\&   You will only need to do this once.  Afterwards, enter the "boot"
\&   command or reboot the system to proceed to the next stage of the
\&   installation.
.Ve
.Sp
L'exemple ci-dessus possède un commentaire sans directive \f(CW\*(C`#flag:comment\*(C'\fR,
pour lequel un commentaire implicite \f(CW\*(C`#flag:comment:*\*(C'\fR est ajouté. Ce
commentaire apparaît avec toutes les chaînes, mais celui à propos de \f(CW\*(C`Stop
for Maintenance\*(C'\fR est affiché seulement avant la chaîne appropriée.
.IP "\fBpartial\fR" 3
.IX Item "partial"
Ce mot clé signifie à \fBpo2debconf\fR de garder les chaînes traduites même si
elles ne sont pas toutes traduites. Utilisez ceci avec prudence, ce mot clé
a été introduit pour des cas très particuliers.
.SS "\s-1AVERTIR LES TRADUCTEURS AVANT LA MISE\s0 À \s-1JOUR\s0"
.IX Subsection "AVERTIR LES TRADUCTEURS AVANT LA MISE À JOUR"
Habituellement les traducteurs s'informent depuis les pages d'état des
traductions (voyez ci-dessous) que des traductions ne sont pas à jour et
envoient un correctif qui sera inclus dans une future mise à
jour. Cependant, les développeurs sont encouragés à demander aux
responsables de traductions en retard de fournir une mise à jour, par
exemple une semaine avant. Un outil spécialisé, \fBpodebconf-report-po\fR, a
été écrit pour cet usage. N'hésitez pas à en abuser !
.SH "DÉBOGAGE"
.IX Header "DÉBOGAGE"
Vous remarquerez que \fBdebconf-loadtemplate\fR n'accepte pas de fichier de
traduction comportant des marques d'internationalisation. Cependant un
fichier fusionné sera accepté, donc si vous avez débogué votre configuration
debconf de la façon suivante
.PP
.Vb 3
\&  rm /tmp/{config,templates}.dat{,\-old}
\&  debconf\-loadtemplate debian/templates
\&  DEBIAN_PRIORITY=low debconf \-freadline debian/config configure 28.0
.Ve
.PP
Vous aurez besoin de quelque chose comme cela à la place :
.PP
.Vb 4
\&  po2debconf debian/templates > debian/tmp/DEBIAN/templates
\&  rm /tmp/{config,templates}.dat{,\-old}
\&  debconf\-loadtemplate debian/tmp/DEBIAN/templates
\&  DEBIAN_PRIORITY=low debconf \-freadline debian/config configure 28.0
.Ve
.SH "AVERTISSEMENTS"
.IX Header "AVERTISSEMENTS"
.IP "\(bu" 2
La version 1.2.0 de \f(CW\*(C`debconf\*(C'\fR reconnaît les champs de la forme
\&\fINom\fR\-\fIlangue\fR.\fIcodage\fR, par exemple \f(CW\*(C`Description\-de.ISO\-8859\-1\*(C'\fR ou
\&\f(CW\*(C`Choices\-ru.KOI8\-R\*(C'\fR. Par défaut, \fBpo2debconf\fR crée les fichiers de
questionnaire avec ce nouveau format. Les versions plus anciennes de
\&\f(CW\*(C`debconf\*(C'\fR ignorent ces champs et affichent le texte en anglais. Consultez
\&\fBpo2debconf\fR\|(1) pour savoir comment modifier le codage et le format de
sortie.
.IP "\(bu" 2
Une chaîne donnée en anglais ne peut avoir qu'une unique traduction par
langue. Il est impossible de fournir deux traductions différentes en
fonction du contexte. Pour résoudre ce problème, vous pouvez ajouter des
balises spéciales aux différentes occurrences d'une chaîne pour les rendre
distinctes (ces balises ne seront visibles que des traducteurs et seront
supprimées de la chaîne avant l'affichage à l'utilisateur).
.Sp
De telles balises doivent être ajoutées à la fin des chaînes à traduire,
elles doivent commencer par \f(CW\*(C`[ \*(C'\fR (un crochet ouvrant suivi d'une espace) et
se terminer par \f(CW\*(C`]\*(C'\fR (un crochet fermant) et peuvent contenir tout caractère
hormis des crochets et des retours à la ligne. Par exemple \f(CW\*(C`[ blabla]\*(C'\fR est
une balise valable alors que \f(CW\*(C`[ bla[bla]bla]\*(C'\fR ne l'est pas. Pour les mordus
de Perl, les balises correspondent à (et sont supprimées avec) cette
règle :
.Sp
.Vb 1
\&  $msg =~ s/\e[\es[^\e[\e]]*\e]$//s;
.Ve
.IP "\(bu" 2
L'espacement n'est pas géré exactement de la même façon par \f(CW\*(C`po\-debconf\*(C'\fR et
\&\f(CW\*(C`debconf\-utils\*(C'\fR ; avec ce dernier, les paragraphes sont reformatés
lors de la mise à jour et de la fusion des traductions, \f(CW\*(C`debconf\-utils\*(C'\fR est
donc très élégant et les espaces ne sont pas considérés comme faisant partie
des chaînes lors de la détermination des entrées approximatives
(c'est\-à\-dire celles qui requièrent l'attention du traducteur suite à une
modification des originales).
.Sp
D'un autre côté, \f(CW\*(C`po\-debconf\*(C'\fR se repose sur \f(CW\*(C`gettext\*(C'\fR pour détecter les
entrées approximatives et ne traite pas les espaces comme des caractères
particuliers. Ainsi les espaces superflus doivent être supprimés à la fin
des lignes des fichiers maîtres de questionnaires, sinon ils apparaîtront
dans les fichiers \s-1PO\s0 et \s-1POT.\s0
.Sp
Pour la même raison, \fBdebconf-gettextize\fR peut marquer un texte comme
approximatif à cause de différences dans les caractères espaces et les
traducteurs devront modifier eux\-mêmes de telles chaînes. Cela ne survient
qu'une seule fois lors de la conversion des questionnaires au format
\&\f(CW\*(C`po\-debconf\*(C'\fR, à moins que vous ne modifiez aléatoirement les espaces dans
les fichiers maîtres de questionnaires, ce qui gênerait les traducteurs.
.IP "\(bu" 2
Normalement, le champ \fIDefault:\fR ne doit pas être traduit pour les types de
questionnaires \fBSelect\fR et \fBMultiselect\fR. Dans de rares circonstances (par
exemple lors du choix de la langue par défaut pour une application) une
valeur régionale peut être plus appropriée.
.Sp
La valeur fournie par le traducteur ne doit pas être une simple traduction,
mais doit au contraire être choisie parmi les valeurs en anglais listées
dans le champ \fIChoices\fR. Le meilleur moyen de l'indiquer est d'ajouter un
commentaire dans le fichier de questionnaire, qui sera recopié dans le
fichier \s-1PO.\s0
.Sp
.Vb 10
\&  Template: geneweb/lang
\&  Type: select
\&  _\|_Choices: Danish (da), Dutch (nl), English (en), Esperanto (eo)
\&  #  You must NOT translate this string, but you can change its value.
\&  #  The comment between brackets is used to distinguish this msgid
\&  #  from the one in the Choices list; you do not have to worry about
\&  #  them, and have to simply choose a msgstr among the English values
\&  #  listed in the Choices field above, e.g. msgstr "Dutch (nl)"
\&  _Default: English (en)[ default language]
\&  _Description: Geneweb default language
.Ve
.Sp
La valeur par défaut apparaît aussi dans le champ \fIChoices\fR et les deux ont
des traductions différentes. Dans le premier cas, il s'agit d'une autre
valeur en anglais choisie parmi la liste des valeurs possibles du champ
\&\fIChoices\fR, alors que pour le second cas il s'agit d'une traduction
classique. Comme \f(CW\*(C`gettext\*(C'\fR ne permet pas d'avoir deux traductions
différentes du même texte, les deux champs \fImsgid\fR doivent être
différenciés, ce qui est exactement le but original de l'utilisation des
commentaires entre crochets, comme expliqué précédemment.
.Sp
Avant \f(CW\*(C`po\-debconf\*(C'\fR 0.8.0, ces commentaires étaient inconnus et les
responsables de paquets devaient remplacer le champ \fI_Default:\fR par
\&\fI_DefaultChoice:\fR afin d'indiquer aux traducteurs le caractère spécial de
ce champ :
.Sp
.Vb 7
\&  #. DefaultChoice
\&  msgid ""
\&  "English[ default: do not translate bracketed material, put your "
\&  "own language here but UNTRANSLATED.  If it is not in the list, "
\&  "put English (without bracketed material)]"
\&  msgstr ""
\&  "French"
.Ve
.Sp
Les commentaires dans les fichiers de questionnaires permettent d'éviter
plus facilement les erreurs des traducteurs et sont encouragés.
.SH "PAGES WEB SUR L'ÉTAT DES TRADUCTIONS"
.IX Header "PAGES WEB SUR L'ÉTAT DES TRADUCTIONS"
Les statistiques des traductions \f(CW\*(C`po\-debconf\*(C'\fR sont disponibles sur
<http://www.debian.org/intl/l10n/po\-debconf/> (ou sur l'un des
miroirs) ; ils sont automatiquement mis à jour lorsqu'un paquet est
mis à jour. Seuls les paquets contenant des fichiers
\&\fIdebian/po/templates.pot\fR et \fIdebian/po/POTFILES.in\fR sont pris en compte,
vous devriez donc vous assurer que votre paquet source les fournit.
.PP
Les traducteurs peuvent récupérer les fichiers \s-1PO\s0 et \s-1POT\s0 depuis cette page,
mais ils doivent toujours prendre contact avec le traducteur précédent (son
adresse de courriel peut être trouvée dans le fichier \s-1PO\s0) ou les membres de
l'équipe de traduction sur debian\-l10n\-\fI<langue>\fR\f(CW@lists\fR.debian.org
(si une telle liste existe, comme c'est le cas pour le français avec
debian\-l10n\-french@lists.debian.org), pour vérifier que personne n'effectue
actuellement le même travail. Lisez aussi les rapports de bogues sur le
paquet que vous êtes en train de traduire pour vérifier si une traduction
n'a pas déjà été soumise.
.PP
Après avoir traduit ces fichiers, ils devraient soumettre leur travail au
responsable du paquet par un rapport de bogue de sévérité \fBwishlist\fR
(souhaitable) avec le marqueur \fBpatch\fR (rustine).
.SH "VOIR AUSSI"
.IX Header "VOIR AUSSI"
\&\fBdebconf\-gettextize\fR\|(1), \fBdebconf\-updatepo\fR\|(1), \fBdh_installdebconf\fR\|(1),
\&\fBpodebconf\-report\-po\fR\|(1), \fBpo2debconf\fR\|(1), \fBdebconf\-devel\fR\|(7).
.SH "AUTEURS"
.IX Header "AUTEURS"
.Vb 2
\&  Martin Quinson <Martin.Quinson@ens\-lyon.fr>
\&  Denis Barbier <barbier@linuxfr.org>
.Ve
.SH "TRADUCTION"
.IX Header "TRADUCTION"
.Vb 2
\&  Nicolas Bertolissio <nico.bertol@free.fr>
\&  Denis Barbier <barbier@linuxfr.org>
.Ve