NOM

       Locale::Po4a::AsciiDoc - Convertir les documents AsciiDoc depuis ou vers des fichiers PO

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.

       Locale::Po4a::AsciiDoc est un module qui permet d'aider la traduction de documentations au format
       AsciiDoc.

OPTIONS ACCEPTÉES PAR CE MODULE

       Voici les options particulières à ce module :

       definitions
           Le  nom  d'un  fichier  contenant  des  définitions  pour po4a, telles qu'elles sont décrites dans la
           section PERSONNALISATION EN LIGNE. Vous pouvez utiliser cette  option  s'il  n'est  pas  possible  de
           placer les définitions dans le document à traduire.

           Dans  un  fichier  de définitions, les lignes ne doivent pas commencer par deux barres obliques, mais
           directement par po4a:.

       entry
           Liste d'entrées d'attribut, séparées par des espaces, que vous souhaitez traduire. Par défaut, aucune
           entrée d'attribut ne peut être traduite.

       macro
           Liste de définitions de macro, séparées par des espaces.

       style
           Liste de définitions de style, séparées par des espaces.

PERSONNALISATION EN LIGNE

       Le module AsciiDoc peut être personnalisé à l'aide de lignes commençant  par  //po4a:.  Ces  lignes  sont
       interprétées comme des commandes pour l'analyseur. Les commandes suivantes sont reconnues :

       //po4a: macro nom[liste d'attributs]
           Cela  permet  de  décrire  précisément  les  paramètres d'une macro. Le nom doit être un nom de macro
           existant, et se termine par un tiret bas si la cible doit être traduite.

           L'argument  liste  d'attributs  est  une  liste,  séparées  par  des  virgules,  qui   contient   des
           renseignements  sur  les argument à traduire. Cette liste contient soit des nombres, pour définir des
           paramètres de position, soit des attributs nommés.

           Si un signe plus (+) précède le nom, alors la macro et ses arguments sont traduits comme un ensemble.
           Il n'est pas nécessaire de définir de liste d'attributs dans ce cas, mais les crochets  doivent  être
           présents.

       //po4a: style [liste d'attributs]
           Cela permet de décrire précisément les attributs de style qui doivent être traduits.

           L'argument   liste   d'attributs  est  une  liste,  séparées  par  des  virgules,  qui  contient  des
           renseignements sur les argument à traduire. Cette liste contient soit des nombres, pour  définir  des
           paramètres  de  position,  soit  des attributs nommés. Le premier attribut est le nom du style, il ne
           sera pas traduit.

           Si un signe plus (+) précède le nom du style, alors  la  liste  d'attributs  est  traduite  comme  un
           ensemble. Il n'est pas nécessaire de définir les attributs à traduire dans ce cas.

           Si un signe moins (-) précède le nom du style, alors cet attribut n'est pas traduit.

       //po4a: entry nom
           Cela déclare une entrée d'attribut à traduire. Par défaut, elles ne sont pas traduites.

ÉTAT DE CE MODULE

       Testé avec succès sur des fichiers AsciiDoc simples.

AUTEURS

        Nicolas François <nicolas.francois@centraliens.net>
        Denis Barbier <barbier@linuxfr.org>

TRADUCTION

        Martin Quinson (mquinson#debian.org)

COPYRIGHT ET LICENCE

        Copyright 2005-2008 par Nicolas FRANÇOIS <nicolas.francois@centraliens.net>.
        Copyright 2012 par Denis BARBIER <barbier@linuxfr.org>.
        Copyright 2017 par Martin Quinson <mquinson#debian.org>.

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

Outils po4a                                        2017-08-26                        Locale::Po4a::AsciiDoc(3pm)