
        *****************************************************
        *           GENERATED FILE, DO NOT EDIT             *
        * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION *
        *****************************************************

This file was generated by po4a(7). Do not store it (in VCS, for example),
but store the PO file used as source file by po4a-translate.

In fact, consider this as a binary, and the PO file as a regular .c file:
If the PO get lost, keeping this translation up-to-date will be harder.

=encoding UTF-8

1;

__END__

=head1 NAME

Locale::Po4a::SimplePod - konvertiert POD-Daten von/in PO-Dateien, mit
Pod::Simple

=head1 ÜBERSICHT

  [po4a_paths] /Pfad/zu/pot $lang:/Pfad/zu/po
  [type:SimplePod] /Pfad/zu/Quell.pod $lang:/Pfad/zu/übersetztem.pod

oder

  [po4a_paths] /Pfad/zu/pot $lang:/Pfad/zu/po
  [po4a_alias:pod] SimplePod
  [type:pod] /Pfad/zu/Quell.pod $lang:/Pfad/zu/übersetztem.pod

=head1 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.

Die Hauptunterschiede zwischen dem aktuellen Pod-Format und dem
SimplePod-Format sind wie folgt:

=over

=item *

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.

=item *

Absätze können mit Zeilenumbruch dargestellt werden. Das Modul
L<Pod::Parser> könnte besondere Handhabungen für Zeilenumbruch anwenden,
wodurch die Nachbildung mit L<Pod::Simple> schwierig wird. Allerdings
scheint L<Pod::Simple> eine natürlichere Ausgabe zu erstellen.

=item *

In SimplePod enthält die Meldung C<=for> (z.B. C<=für Kommentartext>) keinen
Formatnamen (wie C<comment>), 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 C<comment text> führt. Das frühere Verhalten wird
für Übersetzer als komfortabler betrachtet.

=item *

Einträge wie der nachfolgende, die C<=end comment> anzeigen, werden nicht
mehr so dargestellt, wie es das aktuelle Pod-Modul macht. Da dies keine
übersetzbaren Meldungen sind, ist deren Abwesenheit eine Verbesserung.

  #. type: =end
  #: sample.pod:10
  msgid "comment"
  msgstr ""

=item *

Textblöcke, deren POD-Formatgültigkeit nicht sicher ist, werden jetzt als
C<no-wrap> behandelt. Dies gilt beispielsweise für den Inhalt innerhalb
eines Blocks C<=begin html>. Im Pod-Modul wurden sie nicht als C<no-wrap>
behandelt, was manchmal zu Zeilenumbrüchen führte.

=item *

Der Parameter C<=begin> 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.

=back

=head1 STATUS DIESES MODULS

Das Modul ist noch ganz neu entwickelt, daher ist es weniger stabil als
L<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.

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.

Das Modul ist als Ersatz für das aktuelle Modul L<Locale::Po4a::Pod>
gedacht. Der Grund liegt darin, dass L<Pod::Parser>, der vom aktuellen
L<Locale::Po4a::Pod> verwandt wird, jetzt veraltet ist und es empfohlen
wird, stattdessen L<Pod::Simple> zu verwenden. Siehe auch L<GitHub Ticket
#256 »Consider migrating away from deprecated
C<Pod::Parser>«|https://github.com/mquinson/po4a/issues/256>.

=head1 SIEHE AUCH

L<Pod::Simple>, L<Locale::Po4a::Pod>, L<Locale::Po4a::TransTractor>,
L<po4a(7)|po4a.7>, L<Locale::Po4a::SimplePod::Parser>.

=head1 AUTOREN

  gemmaro <gemmaro.dev@gmail.com>

=head1 URHEBERRECHT UND LIZENZ

  Copyright (C) 2025 gemmaro <gemmaro.dev@gmail.com>.

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.
