NAME

       Locale::Po4a::Pod - 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.

SIEHE AUCH

       Pod::Parser, Locale::Po4a::Man(3pm), Locale::Po4a::TransTractor(3pm), po4a(7)

AUTOREN

        Denis Barbier <barbier@linuxfr.org>
        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.

Po4a-Werkzeuge                                     2022-01-02                             Locale::Po4a::Pod(3pm)