Locale::Po4a::Pod(3pm) | Outils po4a | Locale::Po4a::Pod(3pm) |
Locale::Po4a::Pod - Convertir des données POD depuis ou vers des fichiers PO
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');
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.
Je pense que ce module est extrêmement stable, et il n’y a qu’un seul problème 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 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 contient :
" #n"
et le mien contient :
"" #n""
Ce qui est logique puisque « C<blabla> » est converti en « "blabla" ».
Voici la liste complète des pages présentant ce problème sur ma machine (pour un total de 564 pages ; notez également que ça dépend 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
En tant que classe dérivée de Pod::Parser, Locale::Po4a::Pod comprend les mêmes méthodes et interfaces. Consultez Pod::Parser pour plus de détails ; en bref, on crée 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 clé/valeur, qui contrôlent le comportement de l’analyseur. Les options communes à tous les dérivés de Pod::Parser sont :
Elle peut prendre la valeur spéciale none, auquel cas aucun guillemet n’est ajouté autour du texte entre C<>.
Pod::Parser, Locale::Po4a::Man(3pm), Locale::Po4a::TransTractor(3pm), po4a(7)
Denis Barbier <barbier@linuxfr.org> Martin Quinson (mquinson#debian.org)
Martin Quinson (mquinson#debian.org)
Copyright © 2002 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).
2023-01-03 | Outils po4a |