
        *****************************************************
        *           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::Pod - Convertir des données POD depuis ou vers des fichiers PO

=head1 SYNOPSIS

    use Locale::Po4a::Pod;
    my $parser = Locale::Po4a::Pod->new (sentence => 0, width => 78);

    # Lecture dans STDIN et écriture dans STDOUT.
    $parser->parse_from_filehandle;

    # Lecture d’un POD dans file.pod, et écriture dans file.txt.
    $parser->parse_from_file ('file.pod', 'file.txt');

=head1 DESCRIPTION

Locale::Po4a::Pod est un module qui permet d’aider la traduction de documentation au format POD (le langage de préférence pour la documentation Perl) vers d’autres langues.

=head1 ÉTAT DE CE MODULE

Je pense que ce module est extrêmement stable, et il n’y a qu’un seul problème connu avec F</usr/lib/perl5/Tk/MainWindow.pod> (et certaines autres pages, voir ci-dessous), qui contient :

  C<" #n">

Manque de chance, dans la version créée par po4a, c’est découpé par les retours à la ligne. Comme résultat, dans la version d’origine, la page de manuel S<contient :>

 " #n"

et le mien S<contient :>

 "" #n""

Ce qui est logique puisque S<« CE<lt>blablaE<gt> »> est converti en S<« "blabla" ».>

Voici la liste complète des pages présentant ce problème sur ma machine (pour un total de 564 S<pages ;> notez également que ça dépend du signe de ponctuation S<choisi) :> /usr/lib/perl5/Tk/MainWindow.pod /usr/share/perl/5.8.0/overload.pod /usr/share/perl/5.8.0/pod/perlapi.pod /usr/share/perl/5.8.0/pod/perldelta.pod /usr/share/perl/5.8.0/pod/perlfaq5.pod /usr/share/perl/5.8.0/pod/perlpod.pod /usr/share/perl/5.8.0/pod/perlre.pod /usr/share/perl/5.8.0/pod/perlretut.pod





=head1 FONCTIONNEMENT INTERNE

En tant que classe dérivée de Pod::Parser, Locale::Po4a::Pod comprend les mêmes méthodes et interfaces. Consultez L<Pod::Parser> pour plus de S<détails ;> en bref, on crée un nouvel analyseur avec C<< Locale::Po4a::Pod->new() >> puis on appelle parse_from_filehandle() ou parse_from_file().

new() accepte des options sous la forme de paires clé/valeur, qui contrôlent le comportement de l’analyseur. Les options communes à tous les dérivés de Pod::Parser sont :

=over 4

=item B<alt>

Lorsqu’elle prend une valeur vraie, elle permet de sélectionner un autre format de sortie qui, entre autres choses, utilise un autre style de titres et d’entrées B<=item> avec un signe deux-points dans la marge de gauche. La valeur par défaut est fausse.

=item B<code>

Lorsqu’elle prend une valeur vraie, elle permet d’inclure dans la sortie les parties non POD du fichier d’entrée. Ceci est utile pour visualiser du code documenté avec des blocs POD en faisant un rendu du POD et en conservant le code intact.

=item B<indent>

Le nombre d’espaces à utiliser pour l’indentation du texte normal, et l’indentation pour les blocs B<=over>. La valeur par défaut est 4.

=item B<loose>

Lorsqu’elle prend une valeur vraie, une ligne blanche est imprimée après les titres B<=head1>. Avec une valeur fausse (par défaut), aucune ligne blanche n’est imprimée après un B<=head1>, même s’il y en a une qui est imprimée après B<=head2>. La valeur par défaut correspond au format attendu pour les pages de S<manuel ;> si vous êtes en train de formater des documents texte arbitraires, une valeur S<« true »> (vrai) pourra résulter en un affichage plus agréable.

=item B<quotes>

Indique la marque de guillemets à utiliser autour du texte entre CE<lt>>. Si cette valeur est un unique caractère, il est utilisé à la fois comme guillemet gauche et S<droit ;> s’il y a deux caractères, le premier est utilisé comme guillemet gauche et le second comme guillemet S<droit ;> s’il y a quatre caractères, les deux premiers sont utilisés comme guillemet gauche et les deux derniers comme guillemets droits.

Elle peut prendre la valeur spéciale B<none>, auquel cas aucun guillemet n’est ajouté autour du texte entre CE<lt>>.

=item B<sentence>

Lorsqu’elle prend la valeur vrai, Locale::Po4a::Pod suppose que chaque phrase se termine par deux espaces, et essayera de conserver ces espaces. Lorsqu’elle prend la valeur faux, toutes les espaces consécutives des paragraphes à ne pas considérer tel quel (S<« non-verbatim »>) sont rassemblés en une seule espace. Par défaut la valeur est vrai.

=item B<width>

La colonne vers laquelle les retours à la ligne sont insérés. La valeur par défaut est 76.

=back

=head1 VOIR AUSSI

L<Pod::Parser>, L<Locale::Po4a::Man(3pm)>, L<Locale::Po4a::TransTractor(3pm)>, L<po4a(7)|po4a.7>

=head1 AUTEURS

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


=head1 TRADUCTION

 Martin Quinson (mquinson#debian.org)

=head1 COPYRIGHT ET LICENCE

Copyright © 2002 SPI, Inc.

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

