Provided by:
po4a_0.41-1_all 
NOM
Locale::Po4a::Pod - Convertir des donnees POD depuis ou vers des
fichiers PO
SYNOPSIS
use Locale::Po4a::Pod;
my $parser = Locale::Po4a::Pod->new (sentence => 0, width => 78);
# Lecture dans STDIN et ecriture dans STDOUT.
$parser->parse_from_filehandle;
# Lecture d'un POD dans file.pod, et ecriture dans file.txt.
$parser->parse_from_file ('file.pod', 'file.txt');
DESCRIPTION
Locale::Po4a::Pod est un module qui permet d'aider la traduction de
documentation au format POD (le langage de preference pour la
documentation Perl) vers d'autres langues.
'ETAT DE CE MODULE
Je pense que ce module est extremement stable, et il n'y a qu'un seul
probleme connu avec /usr/lib/perl5/Tk/MainWindow.pod (et certaines
autres pages, voir ci-dessous), qui contient:
C<" #n">
Manque de chance, dans la version creee par po4a, c'est decoupe par les
retours a la ligne. Comme resultat, dans la version d'origine, le
manuel contenait:
" #n"
et le mien contient:
"" #n""
Ce qui est logique puisque <<C<blabla>>> est converti en <<"blabla">>.
Voici la liste complete des pages presentant ce probleme sur ma machine
(pour un total de 564 pages; notez egalement que ca depend du signe de
ponctuation 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
FONCTIONNEMENT INTERNE
En tant que classe derivee de Pod::Parser, Locale::Po4a::Pod comprend
les memes methodes et interfaces. Consultez Pod::Parser pour plus de
details; en bref, on cree un nouvel analyseur avec
"Locale::Po4a::Pod->new()" puis on appelle parse_from_filehandle() ou
parse_from_file().
new() accepte des options sous la forme de paires cle/valeur, qui
controlent le comportement de l'analyseur. Les options communes a tous
les derives de Pod::Parser sont:
alt Lorsqu'elle prend une valeur vraie, elle permet de selectionner un
autre format de sortie qui, entre autres choses, utilise un autre
style de titres et d'entrees =item avec un signe deux-points dans
la marge de gauche. La valeur par defaut est fausse.
code
Lorsqu'elle prend une valeur vraie, elle permet d'inclure dans la
sortie les parties non POD du fichier d'entree. Ceci est utile pour
visualiser du code documente avec des blocs POD en faisant un rendu
du POD et en conservant le code intact.
indent
Le nombre d'espaces a utiliser pour l'indentation du texte normal,
et l'indentation pour les blocs =over. La valeur par defaut est 4.
loose
Lorsqu'elle prend une valeur vraie, une ligne blanche est imprimee
apres les titres =head1. Avec une valeur fausse (par defaut),
aucune ligne blanche n'est imprimee apres un =head1, meme s'il y en
a une qui est imprimee apres =head2. La valeur par defaut
correspond au format attendu pour les pages de manuel; si vous etes
en train de formater des documents texte arbitraires, une valeur
<<true>> (vrai) pourra resulter en un affichage plus agreable.
quotes
Indique la marque de guillemets a utiliser autour du texte entre
C<>. Si cette valeur est un unique caractere, il est utilise a la
fois comme guillemet gauche et droit; s'il y a deux caracteres, le
premier est utilise comme guillemet gauche et le second comme
guillemet droit; s'il y a quatre caracteres, les deux premiers sont
utilises comme guillemet gauche et les deux derniers comme
guillemets droits.
Elle peut prendre la valeur speciale none, auquel cas aucun
guillemet n'est ajoute autour du texte entre C<>.
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
consecutives des paragraphes a ne pas considerer tel quel (<<non-
verbatim>>) sont rassembles en une seule espace. Par defaut la
valeur est vrai.
width
La colonne vers laquelle les retours a la ligne sont inseres. La
valeur par defaut est 76.
VOIR AUSSI
Pod::Parser, po4a(7), Locale::Po4a::TransTractor(3pm),
Locale::Po4a::Man(3pm),
AUTEURS
Denis Barbier <barbier@linuxfr.org>
Martin Quinson (mquinson#debian.org)
COPYRIGHT ET LICENCE
Copyright 2002 par SPI, inc.
Ce programme est un logiciel libre; vous pouvez le copier et / ou le
modifier sous les termes de la GPL (voir le fichier COPYING).