.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45) .\" .\" 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 .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . 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 .\" .\" Required to disable full justification in groff 1.23.0. .if n .ds AD l .\" ======================================================================== .\" .IX Title "LOCALE::PO4A::SIMPLEPOD.3PM 1" .TH LOCALE::PO4A::SIMPLEPOD.3PM 1 2025-11-22 "perl v5.42.0" "User Contributed Perl Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .PP 1; .PP _\|_END_\|_ .SH NAME Locale::Po4a::SimplePod \- konvertiert POD\-Daten von/in PO\-Dateien, mit Pod::Simple .SH ÜBERSICHT .IX Header "ÜBERSICHT" .Vb 2 \& [po4a_paths] /Pfad/zu/pot $lang:/Pfad/zu/po \& [type:SimplePod] /Pfad/zu/Quell.pod $lang:/Pfad/zu/übersetztem.pod .Ve .PP oder .PP .Vb 3 \& [po4a_paths] /Pfad/zu/pot $lang:/Pfad/zu/po \& [po4a_alias:pod] SimplePod \& [type:pod] /Pfad/zu/Quell.pod $lang:/Pfad/zu/übersetztem.pod .Ve .SH BESCHREIBUNG .IX Header "BESCHREIBUNG" Dies 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. .PP Die Hauptunterschiede zwischen dem aktuellen Pod\-Format und dem SimplePod\-Format sind wie folgt: .IP \(bu 4 Das SimplePod\-Format enthält niemals zusätzliche Zeilenumbrüche in zu übersetzenden Meldungen. Das aktuelle POD\-Format kann allerdings zusätzliche Zeilenumbrüche enthalten, insbesondere in »verbatim«\-Meldungseinträgen. .IP \(bu 4 Absätze können mit Zeilenumbruch dargestellt werden. Das Modul Pod::Parser könnte besondere Handhabungen für Zeilenumbruch anwenden, wodurch die Nachbildung mit Pod::Simple schwierig wird. Allerdings scheint Pod::Simple eine natürlichere Ausgabe zu erstellen. .IP \(bu 4 In SimplePod enthält die Meldung \f(CW\*(C`=for\*(C'\fR (z.B. \f(CW\*(C`=für Kommentartext\*(C'\fR) keinen Formatnamen (wie \f(CW\*(C`comment\*(C'\fR), so dass die Meldung ausschließlich aus Text besteht. Im Gegensatz dazu behält das aktuelle Pod\-Format den Formatnamen bei, was zu Meldungen wie \f(CW\*(C`comment text\*(C'\fR führt. Das frühere Verhalten wird für Übersetzer als komfortabler betrachtet. .IP \(bu 4 Einträge wie der nachfolgende, die \f(CW\*(C`=end comment\*(C'\fR anzeigen, werden nicht mehr so dargestellt, wie es das aktuelle Pod\-Modul macht. Da dies keine übersetzbaren Meldungen sind, ist deren Abwesenheit eine Verbesserung. .Sp .Vb 4 \& #. type: =end \& #: sample.pod:10 \& msgid "comment" \& msgstr "" .Ve .IP \(bu 4 Textblöcke, deren POD\-Formatgültigkeit nicht sicher ist, werden jetzt als \&\f(CW\*(C`no\-wrap\*(C'\fR behandelt. Dies gilt beispielsweise für den Inhalt innerhalb eines Blocks \f(CW\*(C`=begin html\*(C'\fR. Im Pod\-Modul wurden sie nicht als \f(CW\*(C`no\-wrap\*(C'\fR behandelt, was manchmal zu Zeilenumbrüchen führte. .IP \(bu 4 Der Parameter \f(CW\*(C`=begin\*(C'\fR unterliegt jetzt nicht mehr der Übersetzung. Im aktuellen Pod\-Modul wurde er aufgenommen. Falls es Bedarf gibt, ihn in die Übersetzung aufzunehmen, melden Sie sich bitte. .SH "STATUS DIESES MODULS" .IX Header "STATUS DIESES MODULS" Das Modul ist noch ganz neu entwickelt, daher ist es weniger stabil als Locale::Po4a::Pod. Es entwickelt sich weiter und es gibt Raum für Verfeinerungen. Sein Verhalten könnte sich im Laufe der Zeit ändern und zusätzliche Optionen könnten eingeführt werden, um die Übersetzungsleistung für Benutzer zu optimieren. Rückmeldungen und Anwendungsfälle von realen Anwendungen werden eine Schlüsselrolle zum Anleiten der zukünftigen Entwicklung darstellen. .PP Der Code ist vollständig durch unsere Test\-Suite abgedeckt und uns sind keine bestehenden Fehler bekannt. Stand 2025 wurde es aber noch keinen Kampfeinsätzen in realen Übersetzungsabläufen in externen Projekten unterzogen. Trotz dieser Aussage glauben wir, dass das Modul für den Produktionseinsatz bereit ist, selbst wenn es unvermeidlich sein könnte, dass einige Fehler entdeckt werden, wenn das Modul breiteren Einsatz findet. .PP Das Modul ist als Ersatz für das aktuelle Modul Locale::Po4a::Pod gedacht. Der Grund liegt darin, dass Pod::Parser, der vom aktuellen Locale::Po4a::Pod verwandt wird, jetzt veraltet ist und es empfohlen wird, stattdessen Pod::Simple zu verwenden. Siehe auch GitHub Ticket #256 »Consider migrating away from deprecated \&\f(CW\*(C`Pod::Parser\*(C'\fR« . .SH "SIEHE AUCH" .IX Header "SIEHE AUCH" Pod::Simple, Locale::Po4a::Pod, Locale::Po4a::TransTractor, \&\fBpo4a\fR\|(7), Locale::Po4a::SimplePod::Parser. .SH AUTOREN .IX Header "AUTOREN" .Vb 1 \& gemmaro .Ve .SH "URHEBERRECHT UND LIZENZ" .IX Header "URHEBERRECHT UND LIZENZ" .Vb 1 \& Copyright (C) 2025 gemmaro . .Ve .PP Dieses Programm ist freie Software; Sie können es unter den Bedingungen der GPL v2.0 oder neuer (siehe die Datei COPYING) vertreiben und/oder verändern.