Locale::Po4a::Pod(3) konvertiert POD-Daten von/in PO-Dateien

ÜBERSICHT


use Locale::Po4a::Pod;
my $parser = Locale::Po4a::Pod->new (sentence => 0, width => 78);
# POD von STDIN lesen und nach STDOUT schreiben
$parser->parse_from_filehandle;
# POD aus Datei.pod lesen und nach Datei.txt schreiben
$parser->parse_from_file ('Datei.pod', 'Datei.txt');

BESCHREIBUNG

Locale::Po4a::Pod ist ein Modul, um bei der Übersetzung von Dokumentation in dem POD-Format (dem für Perl-Dokumentierung bevorzugten Format) in andere [natürliche] Sprachen zu helfen.

STATUS DIESES MODULS

Ich denke, dieses Modul ist stabil wie ein Felsen und es gibt nur einen bekannten Fehler mit /usr/lib/perl5/Tk/MainWindow.pod (und einigen anderen Seiten, siehe unten), in der Folgendes steht:

  C<" #n">

Durch fehlendes Glück wurde in der Po4a-Version dies beim Leerzeichen umgebrochen. Dadurch enthielt die Ursprungsversion des Handbuchs

 " #n"

und meine enthielt

 "" #n""

was logisch ist, da C<foobar> in ``foobar'' umgeschrieben wird.

Vollständige Liste von Seiten, die auf meiner Maschine dieses Problem haben (von 564 Seiten, beachten Sie, dass dies von der gewählten Umbruchspalte abhängt): /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

INTERNA

Als abgeleitete Klasse von Pod::Parser unterstützt Locale::Po4a::Pod die gleichen Methoden und Schnittstellen. Lesen Sie Pod::Parser für alle Details; in Kürze, ein neuer Parser wird mit "Locale::Po4a::Pod->new()" erstellt und dann wird entweder parse_from_filehandle() oder parse_from_file() aufgerufen.

new() akzeptiert Optionen in der Form von Schlüssel/Wert-Paaren, die das Verhalten des Parsers steuern. Die von allen Pod::Parser-Kindern erkannten Optionen sind:

alt
Falls dies auf einen wahren Wert gesetzt wird, wird unter anderem ein alternatives Ausgabeformat ausgewählt, ein anderer Stil für Überschriften gewählt und =item-Einträge mit einem Doppelpunkt in der linken Spalte markiert. Standardmäßig »false«.
code
Falls dies auf einen wahren Wert gesetzt wird, wird der nicht POD-Teil der Eingabedatei in der Ausgabe eingeschlossen. Nützlich, um Code, der mit POD-Blöcken dokumentiert ist, mit dem dargestellten POD und dem inktakt verbliebenen Code anzuschauen.
indent
Die Anzahl der Leerzeichen, um regulären Text einzurücken sowie die Vorgabe für die Einrückung für =over-Blöcke. Standardmäßig 4.
loose
Falls dies auf einen wahren Wert gesetzt wird, wird eine Leerzeile nach einer =head-Zeile ausgegeben. Falls auf den Standardwert »false« gesetzt, wird keine Leerzeile nach =head1 ausgegeben, obwohl nach =head2 weiterhin eine ausgegeben wird. Dies ist die Vorgabe, da dies der bei Handbuchseiten erwarteten Formatierung entspricht; falls Sie beliebige Texte formatieren, könnte das Setzen auf »true« zu einer schöneren Ausgabe führen.
quotes
Setzt die Anführungszeichen, die C<>-Text umfassen sollen. Falls der Wert ein einzelnes Zeichen ist, wird dieses sowohl als linkes als auch als rechtes Anführungszeichen verwandt. Falls es sich um zwei Zeichen handelt, wird das erste als öffnendes Anführungszeichen (links) und das zweite als schließendes Anführungszeichen (rechts) verwandt. Falls es sich um vier Zeichen handelt, werden die ersten zwei als öffnende und die anderen zwei als schließende Anführungszeichen verwandt.

Dies kann auch auf den speziellen Wert none gesetzt werden. In diesem Fall werden um C<>-Text keine Anführungszeichen gesetzt.

sentence
Falls dies auf einen wahren Wert gesetzt wird, wird Locale::Po4a::Pod annehmen, dass jeder Satz mit zwei Leerzeichen endet und versuchen, diese Leerzeichen zu erhalten. Falls auf »false« gesetzt, werden alle direkt aufeinander folgenden Leerzeichen in Absätzen, die nicht direkt ausgegeben werden, in ein einzelnes Leerzeichen zusammengefasst. Standardmäßig »true«.
width
Die Spalte, an der Text auf der rechten Seite umgebrochen werden soll. Standardmäßig 76.

AUTOREN

 Denis Barbier <[email protected]>
 Martin Quinson (mquinson#debian.org)

URHEBERRECHT UND LIZENZ

Copyright 2002 SPI, Inc.

Dieses Programm ist freie Software; Sie können es unter den Bedingungen der GPL (siehe die Datei COPYING) vertreiben und/oder verändern.