.\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "Locale::Po4a::Pod 3pm" .TH Locale::Po4a::Pod 3pm "2018-12-09" "Po4a-Werkzeuge" "Po4a-Werkzeuge" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" Locale::Po4a::Pod \- konvertiert POD\-Daten von/in PO\-Dateien .SH "ÜBERSICHT" .IX Header "ÜBERSICHT" .Vb 2 \& 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 (\*(AqDatei.pod\*(Aq, \*(AqDatei.txt\*(Aq); .Ve .SH "BESCHREIBUNG" .IX Header "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. .SH "STATUS DIESES MODULS" .IX Header "STATUS DIESES MODULS" Ich denke, dieses Modul ist stabil wie ein Felsen und es gibt nur einen bekannten Fehler mit \fI/usr/lib/perl5/Tk/MainWindow.pod\fR (und einigen anderen Seiten, siehe unten), in der Folgendes steht: .PP .Vb 1 \& C<" #n"> .Ve .PP Durch fehlendes Glück wurde in der Po4a\-Version dies beim Leerzeichen umgebrochen. Dadurch enthielt die Ursprungsversion des Handbuchs .PP .Vb 1 \& " #n" .Ve .PP und meine enthielt .PP .Vb 1 \& "" #n"" .Ve .PP was logisch ist, da C in \*(L"foobar\*(R" umgeschrieben wird. .PP 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 .SH "INTERNA" .IX Header "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 \f(CW\*(C`Locale::Po4a::Pod\->new()\*(C'\fR erstellt und dann wird entweder \fBparse_from_filehandle()\fR oder \&\fBparse_from_file()\fR aufgerufen. .PP \&\fBnew()\fR 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: .IP "\fBalt\fR" 4 .IX Item "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 \fB=item\fR\-Einträge mit einem Doppelpunkt in der linken Spalte markiert. Standardmäßig »false«. .IP "\fBcode\fR" 4 .IX Item "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 \s-1POD\s0 und dem inktakt verbliebenen Code anzuschauen. .IP "\fBindent\fR" 4 .IX Item "indent" Die Anzahl der Leerzeichen, um regulären Text einzurücken sowie die Vorgabe für die Einrückung für \fB=over\fR\-Blöcke. Standardmäßig 4. .IP "\fBloose\fR" 4 .IX Item "loose" Falls dies auf einen wahren Wert gesetzt wird, wird eine Leerzeile nach einer \fB=head\fR\-Zeile ausgegeben. Falls auf den Standardwert »false« gesetzt, wird keine Leerzeile nach \fB=head1\fR ausgegeben, obwohl nach \fB=head2\fR 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. .IP "\fBquotes\fR" 4 .IX Item "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. .Sp Dies kann auch auf den speziellen Wert \fBnone\fR gesetzt werden. In diesem Fall werden um C<>\-Text keine Anführungszeichen gesetzt. .IP "\fBsentence\fR" 4 .IX Item "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«. .IP "\fBwidth\fR" 4 .IX Item "width" Die Spalte, an der Text auf der rechten Seite umgebrochen werden soll. Standardmäßig 76. .SH "SIEHE AUCH" .IX Header "SIEHE AUCH" Pod::Parser, \fBLocale::Po4a::Man\fR\|(3pm), \&\fBLocale::Po4a::TransTractor\fR\|(3pm), \fBpo4a\fR\|(7) .SH "AUTOREN" .IX Header "AUTOREN" .Vb 2 \& Denis Barbier \& Martin Quinson (mquinson#debian.org) .Ve .SH "URHEBERRECHT UND LIZENZ" .IX Header "URHEBERRECHT UND LIZENZ" Copyright © 2002 \s-1SPI,\s0 Inc. .PP Dieses Programm ist freie Software; Sie können es unter den Bedingungen der \&\s-1GPL\s0 (siehe die Datei \s-1COPYING\s0) vertreiben und/oder verändern.