NOM

       debconf-gettextize - Convertir des questionnaires debconf en fichiers PO

SYNOPSIS

       debconf-gettextize [-v] [-h] [--podir=RÉP] [--choices] [--merge] maître [maître ...]

DESCRIPTION

       Les fichiers /var/lib/dpkg/info/*.templates lus par debconf contiennent à la fois les chaînes anglaises
       et les traductions. Mais dans les paquets sources, les traductions sont gérées dans des fichiers séparés
       afin de faciliter le travail des traducteurs. À l'origine, un fichier templates maître ne contenait que
       les chaînes en anglais et les fichiers templates.xx contenaient les traductions pour les langues xx ainsi
       que les chaînes anglaises sur lesquelles les traductions sont basées. Le programme debconf-mergetemplate
       fusionnait ces fichiers.

       La nouvelle mouture avec « po-debconf » est basée sur « gettext ». Les développeurs marquent les champs à
       traduire en les précédant d'un souligné (underscore). Les chaînes anglaises sont automatiquement copiées
       dans un fichier POT, les traducteurs travaillent sur les fichiers PO habituels et po2debconf produit un
       fichier qui est identique à celui produit auparavant par debconf-mergetemplate.

       Le programme debconf-gettextize est fourni afin de faciliter cette migration.

       • Il lit une liste de fichiers maîtres et leurs traductions puis produit des fichiers po/*.po pour chaque
         langue contenant des chaînes traduites.

       • Le  suffixe  « .old »  est  ajouté  à  chaque  fichier  d'entrée  et un nouveau fichier maître remplace
         l'ancien ; il est identique au fichier maître hormis qu'un caractère souligné est ajouté devant  chaque
         champ  à  traduire.  Les  développeurs  peuvent  alors choisir sur quels champs les traducteurs doivent
         travailler et quels sont ceux dont la valeur ne dépend pas des paramètres régionaux et qui doivent être
         ignorés.

       • Un fichier po/POTFILES.in est également créé. Celui-ci contient la liste des fichiers templates  devant
         être traités par debconf-updatepo.

       Normalement,  le programme debconf-gettextize n'est invoqué qu'une seule fois, lors de la conversion vers
       le format « po-debconf ». Mais il peut aussi  être  utilisé  par  la  suite  pour  transformer  un  champ
       « _Choices »  en  « __Choices »  (ou  inversement)  sans  perdre  les traductions existantes, à l'aide de
       l'option  « --merge »  (éventuellement  avec  « --choices »).  Le  questionnaire   contenant   le   champ
       « _Choices »  ou  « __Choices »  à  modifier  est  recopié  dans  un fichier temporaire, qui est passé en
       paramètre de debconf-gettextize. Les étapes suivantes sont alors réalisées :

       1. po2debconf est exécuté  sur  ce  questionnaire  pour  produire  un  fichier  templates  contenant  les
          traductions.

       2. Ce fichier est converti comme expliqué ci-dessus en fichiers PO.

       3. Ces fichiers PO sont fusionnés avec ceux qui existent déjà.

       Une  fois les fichiers PO fusionnés, les champs « _Choices » doivent être remplacés par « __Choices » (ou
       inversement) dans les questionnaires debconf avant d'exécuter  debconf-updatepo,  sinon  les  traductions
       seront marquées comme étant approximatives (« fuzzy »).

OPTIONS

       -h, --help
           Affiche un résumé sur l'utilisation du programme, puis quitte.

       -v, --verbose
           Réalise le traitement en mode bavard.

       --podir=RÉP
           Spécifie  le  répertoire  des  fichiers  PO.  Par  défaut,  les  fichiers  PO sont recherchés dans le
           sous-répertoire po de l'emplacement du premier fichier maître.

       --choices
           Par défaut, debconf-gettextize remplace les champs « Choices » par « _Choices ». Avec  cette  option,
           des champs « __Choices » seront écrits.

       --merge
           Fusionne  les  chaînes  traduites  avec  des  fichiers PO existants. Les questionnaires debconf et le
           fichier po/POTFILES.in ne sont pas modifiés.

AVERTISSEMENTS

       Le champ « Default » est particulier pour les types  de  questionnaires  « Select »  et  « Multiselect »,
       parce  qu'une  valeur  doit  être  choisie  parmi  la  liste  de  choix en anglais, même pour les valeurs
       régionales. Normalement, ce champ ne doit pas être modifié, mais dans de rares circonstances, des valeurs
       régionales ont un sens (par exemple lors du choix de la langue par défaut  d'une  application).  Afin  de
       permettre  aux  traducteurs  de  savoir que la valeur régionale de ce champ « Default » est particulière,
       vous devez, par convention, l'appeler « _DefaultChoice » au lieu de « _Default ».

VOIR AUSSI

       debconf-updatepo(1), po2debconf(1), debconf-devel(7), po-debconf(7).

AUTEURS

         Denis Barbier <barbier@linuxfr.org>
         Martin Quinson <martin.quinson@ens-lyon.fr>

TRADUCTION

         Nicolas Bertolissio <nico.bertol@free.fr>
         Denis Barbier <barbier@linuxfr.org>

                                                   2020-12-30                              DEBCONF-GETTEXTIZE(1)