
        *****************************************************
        *           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

Locale::Po4a::Sgml - Convertir des documents SGML depuis ou vers des
fichiers PO

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

Locale::Po4a::Sgml est un module qui permet d’aider la traduction de
documentations au format SGML vers d’autres langues.

Ce module utilise B<onsgmls>(1) pour analyser les fichiers SGML. Assurez
vous qu’il est bien installé et que la DTD des fichiers SGML est bien
installée sur le système.

=head1 OPTIONS ACCEPTÉES PAR CE MODULE

=over 4

=item B<debug>

Liste de mots clefs séparés par des espaces et indiquant quelles catégories
de messages de débogage supplémentaire devraient être affichées. Les valeurs
possibles sont C<entities>, C<generic>, C<onsgml>, C<refs> et C<tag>.

=item B<verbose>

Donne plus d’informations sur ce qu’il se passe.

=item B<translate>

Liste de balises supplémentaires (en plus de celles fournies par la DTD)
séparées par des espaces dont le contenu doit former des msgid additionnels,
c’est-à-dire pour être traduites.

=item B<section>

Liste de balises supplémentaires (en plus de celles fournies par la DTD)
pouvant contenir d’autres balises, qui peuvent être à traduire (catégorie
B<translate>).

=item B<indent>

Space-separated list of tags which increase the indentation level. This will
affect the indentation in the resulting document.

=item B<verbatim>

Le formatage du texte contenu dans ces balises ne doit pas être
modifié. Aucun retour à la ligne n’est ajouté dans les paragraphes et aucune
espace pour l’indentation ou nouvelle ligne n’est ajoutée pour des raisons
cosmétiques.

=item B<empty>

Balises n’ayant pas besoin d’être fermées.

=item B<ignore>

Tags ignored and considered as plain char data by po4a. That is to say that
they can be part of an msgid. For example, E<lt>bE<gt> is a good candidate
for this category since putting it in the B<translate> section would create
a msgids with only its content, (and it's usually not a whole sentence),
which is bad.

=item B<attributes>

Une liste d’attributs de balises (séparés par des espaces) que vous voulez
traduire. Vous pouvez spécifier les attributs par leur nom (par exemple,
C<lang>), mais vous pouvez aussi les faire précéder d’une hiérarchie de
balises pour indiquer que cet attribut ne sera traduit que quand il sera
placé à l’intérieur d’une balise. Par exemple : C<< <bbb><aaa>lang >>
indique que l’attribut lang ne sera traduit que s’il se trouve dans une
balise C<< <aaa> >>, se trouvant elle-même dans une balise C<< <bbb> >>. Le
nom des balises est en fait une expression rationnelle, ce qui vous permet
de spécifier C<< <aaa|bbb>lang >> si vous ne voulez traduire que les
attributs C<lang> qui se trouvent dans une balise C<< <aaa> >> ou C<< <bbb>
>>.

=item B<qualify>

A space-separated list of attributes for which the translation must be
qualified by the attribute name, i.e. the text extracted for the translation
will include both the attributes name and it's value. e.g. for a tag like
C<< <aaa lang_en="foo"> >> translators will be presented with the string
C<lang_en="foo">. Note that this also automatically adds the given attribute
into the B<attributes> list too.

=item B<force>

Continue même si la DTD est inconnue ou si B<onsgmls> trouve des erreurs
dans le document d’entrée.

=item B<include-all>

Par défaut, les msgid qui ne contiennent qu’une entité (comme « C<&version;>
») sont sautés pour le confort des équipes de traduction. Activer cette
option arrête cette optimisation. Ceci peut être utile si le document
contient une construction telle que C<< <title>&Aacute;</title> >>, même
s’il est peu probable que cela arrive...

=item B<ignore-inclusion>

Liste d’entités, séparées par des espaces, qui ne seront pas
insérées. Utilisez cette option avec précaution : elle peut forcer
B<onsgmls> (qui est utilisé en interne) à ajouter des tags et rendre le
document généré non valable.

=back

=head1 ÉTAT DE CE MODULE

Le résultat est parfait. C’est-à-dire que les documents générés sont
rigoureusement identiques aux originaux. Mais il reste encore quelques
problèmes :

=over 2

=item *

Les messages d’erreur de B<onsgmls> sont redirigés vers /dev/null par
défaut, ce qui n’est pas bien, mais je ne sais pas comment éviter cela.

Le problème est que j’ai à « protéger » les inclusions conditionnées (c’est
à dire « C<E<lt>! [ %truc [> » et « C<]]E<gt>> machin ») de
B<onsgmls>. Sinon, B<onsgmls> les élimine, et je ne sais pas les rétablir
dans le document final. Pour empêcher cela, je les récris dans
C<{PO4A-beg-truc}> et C<{PO4A-end}>.

Le problème avec cela est que les C<{PO4A-end}> et autres sont non valables
dans le document (sauf dans une balise E<lt>pE<gt> ou autre).

Si vous souhaitez afficher la sortie d’B<onsgmls>, il suffit d’ajouter ce
qui suit à votre ligne de commande (ou à la ligne de configuration po4a) :

  -o debug=onsgmls

=item *

Cela ne marche qu’avec les DTD DebianDoc et DocBook. L’ajout de prise en
charge d’une nouvelle DTD doit être très facile. Le mécanisme est le même
pour chaque DTD, vous n’avez qu’à donner la liste des balises existantes et
certaines de leurs caractéristiques.

Je comprend que cela nécessiterait plus de documentation, mais c’est
toujours considéré comme à l’état bêta, et je déteste documenter ce qui
risque de/va changer.

=item *

Attention, la prise en charge des DTD est plutôt expérimentale. Je n’ai lu
aucun manuel de référence pour trouver la définition de toutes ces
balises. J’ai ajouté des définitions de balises au module jusqu’à ce que ça
marche pour certains documents trouvés sur Internet. Si votre document
utilise plus de balises que les miens, ça ne marchera pas. Mais, comme je
l’ai dit plus haut, corriger cela doit être assez facile.

J’ai testé le format DocBook avec le SAG (System Administrator Guide --
Guide de l’Administrateur Système) uniquement, mais comme ce document est
assez important, il doit utiliser la plupart des spécificités de DocBook.

Pour le format DebianDoc, je l’ai testé avec certains manuels du DDP, mais
pas encore avec tous.

=item *

En cas d’inclusion d’un fichier, les références des messages du PO (c.-à-d.,
les lignes de la forme C<#: en/titletoc.sgml:9460>) seront erronées.

Cela est dû au fait que j’applique un prétraitement au fichier pour protéger
les inclusions conditionnelles (utilisant « C<E<lt>! [ %truc [> » et
« C<]]E<gt>> machin ») et quelques entités (comme C<&version;>) de
B<onsgmls> parce que je les veux telles quelles dans le document
généré. Pour cela, je fais une copie temporaire du fichier d’entrée et
effectue toutes les modifications que je veux lui appliquer avant de le
passer à B<onsgmls> pour son analyse.

Pour que ça fonctionne, je remplace les entités demandant l’inclusion d’un
fichier par le contenu du fichier donné (comme cela je peux également
protéger ce qui doit être dans le sous-fichier). Mais rien n’est fait à
présent pour corriger les références (c.-à-d. les noms des fichiers et les
numéros de ligne) par la suite. Je ne sais pas ce qui est préférable.

=back

=head1 AUTEURS

Ce module est une adaptation de sgmlspl (postprocesseur SGML pour
l’analyseur ONSGMLS), qui était :

 Copyright © 1995 David Megginson <dmeggins@aix1.uottawa.ca>

L’adaptation de po4a a été faite par :

 Denis Barbier <barbier@linuxfr.org>
 Martin Quinson (mquinson#debian.org)


=head1 TRADUCTION

 Martin Quinson (mquinson#debian.org)

=head1 COPYRIGHT ET LICENCE

 Copyright © 1995 David Megginson <dmeggins@aix1.uottawa.ca>.
 Copyright © 2002-2005 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).
