
        *****************************************************
        *           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

=head1 NAME

Locale::Po4a::Sgml - konvertiert SGML-Dokumente von/in PO-Dateien

=head1 BESCHREIBUNG

Das Projektziel von Po4a (PO für alles) ist es, die Übersetzung (und
interessanter, die Wartung der Übersetzung) zu vereinfachen, indem die
Gettext-Werkzeuge auch für Gebiete verwendet werden, wo diese nicht erwartet
werden, wie Dokumentation.

Locale::Po4a::Sgml ist ein Modul, um bei der Übersetzung von Dokumentation
im SGML-Format in andere [natürliche] Sprachen zu helfen.

Dieses Module verwendet B<onsgmls>(1), um SGML-Dateien auszuwerten. Stellen
Sie daher sicher, dass es installiert ist. Stellen Sie auch sicher, dass die
DTD- der SGML-Dateien im System installiert sind.

=head1 VON DIESEM MODUL AKZEPTIERTE OPTIONEN

=over 4

=item B<debug>

Durch Leerzeichen getrennte Liste von Schlüsselwörtern, die angeben, welche
Kategorie von zusätzlichen Fehlersuchmeldungen angezeigt werden
soll. Möglich Werte sind: C<entities>, C<generic>, C<onsgml>, C<refs> und
C<tag>.

=item B<verbose>

mehr Informationen darüber ausgeben, was vorgeht

=item B<translate>

durch Leerzeichen getrennte Liste von zusätzlichen Markierungen (»Tags«)
(neben denen von der DTD vorgegebenen), deren Inhalt eine zusätzliche
»msgid« ergeben soll, d.h. die übersetzt werden sollten.

=item B<section>

durch Leerzeichen getrennte Liste von zusätzlichen Markierungen (»Tags«)
(neben denen von der DTD vorgegebenen), die andere Markierungen enthalten,
wobei einige in die Kategorie B<translate> fallen

=item B<indent>

durch Leerzeichen getrennte Liste von Markierungen (»Tags«), die die
Einzugsstufe erhöhen. Dies wird die Einrückung des Ergebnisdokuments
beeinflussen.

=item B<verbatim>

Das Layout innerhalb dieser Markierungen (»Tags«) sollte nicht geändert
werden. Der Absatz erfährt keinen Zeilenumbruch und keine zusätzliche
Einrückung und keine zusätzliche Zeilen werden für kosmetische Zwecke
eingefügt.

=item B<empty>

Markierungen (»Tags«), die nicht geschlossen werden müssen

=item B<ignore>

Markierungen (»Tags«), die von Po4a ignoriert und als reine Zeichendaten
betrachtet werden. Das bedeutet, dass sie Teil einer Msgid sein
können. Beispielsweise ist E<lt>bE<gt> ein guter Kandidat für diese
Kategorie, da das Hinzufügen in den Abschnitt B<translate> Msgids nur mit
ihrem Inhalt erzeugen würde (der normalerweise kein ganzer Satz ist), was
schlecht wäre.

=item B<attributes>

Eine durch Leerzeichen getrennte Liste von Attributen, die nicht übersetzt
werden müssen. Sie können die Attribute mit ihrem Namen (beispielsweise
C<lang>) angeben, aber Sie können ihnen auch eine Markierungs-
(»Tag«-)Hierarchie voranstellen, um anzugeben, dass dieses Attribut nur
übersetzt wird, wenn es Teil der angegebenen Markierung ist. Beispielsweise
spezifiziert C<< <bbb><aaa>lang >>, dass das Attribut C<lang> nur übersetzt
werden soll, wenn es Teil der Markierung C<< <aaa> >> ist, die wiederum Teil
der Markierung C<< <bbb> >> ist. Die Namen der Markierungen sind eigentlich
reguläre Ausdrücke, daher können Sie auch Formulierungen wie C<<
<aaa|bbb>lang >> wählen, um das Attribut C<lang> nur zu übersetzen, wenn es
sich in der Markierung C<< <aaa> >> oder a C<< <bbb> >>befindet.

=item B<qualify>

Eine durch Leerzeichen getrennte Liste von Attributen, für die die
Übersetzung über den Attributnamen qualifiziert werden muss, d.h. der für
die Übersetzung herausgelöste Text wird sowohl den Attributnamen als auch
seinen Werte enthalten. Für eine Markierung wie C<< <aaa lang_en="foo"> >>
wird Übersetzern beispielsweise die Zeichenkette C<lang_en="foo">
angeboten. Beachten Sie, dass diese Einstellung das angegebene Attribut auch
automatisch zu der Liste B<attributes> hinzufügt.

=item B<force>

fortfahren, selbst falls die DTD unbekannt ist oder falls B<onsgmls>(1)
Fehler in der Eingabedatei findet

=item B<include-all>

Standardmäßig werden Msgids, die nur eine Entität enthalten (wie
C<&version;>) für angenehmeres Übersetzen übersprungen. Durch Aktivierung
dieser Option wird diese Optimierung vermieden. Dies könnte nützlich sein,
falls das Dokumente Konstrukte wie C<< <title>&Aacute;</title> >> enthält,
selbst wenn ich daran zweifle, dass das jemals passieren wird …

=item B<ignore-inclusion>

Durch Leerzeichen getrennte Liste, die nicht eingefügt wird. Benutzen Sie
diese Option mit Vorsicht: Sie könnte B<onsgmls>(1) (intern benutzt)
veranlassen, Markierungen hinzuzufügen und das Ausgabedokument ungültig zu
berechnen.

=back

=head1 STATUS DIESES MODULS

Das Ergebnis ist perfekt, d.h. die erstellten Dokumente sind identisch mit
den ursprünglichen. Aber es gibt noch ein paar Probleme:

=over 2

=item *

Die Fehlerausgabe von B<onsgmls>(1) wird standardmäßig nach /dev/null
umgeleitet. Dies ist eindeutig schlecht. Ich weiß nicht, wie ich das
vermeiden kann.

Das Problem liegt darin, dass ich die bedingte Einbindung (d.h. das Zeug
C<E<lt>! [ %foo [> und C<]]E<gt>>) vor B<onsgmls>(1) »schützen«
muss. Andernfalls futtert B<onsgmls>(1) das auf und ich weiß nicht, wie ich
das im letztendlichen Dokument wieder herstellen kann. Um das zu vermeiden,
schreibe ich sie in C<{PO4A-beg-foo}> und C<{PO4A-end}> um.

Das Problem dabei ist, dass C<{PO4A-end}> und so etwas im Dokument ungültig
sind (nicht in einer E<lt>pE<gt>-Markierung oder so).

Falls Sie die B<onsgmls>(1)-Ausgabe sehen wollen, fügen Sie einfach
Folgendes zu Ihrer Befehlszeile (oder der Po4a-Konfigurationszeile) hinzu:

  -o debug=onsgmls

=item *

Es funktioniert nur mit der DebianDoc- und DocBook-DTD. Hinzunahme der
Unterstützung für eine neue DTD sollte sehr leicht sein. Der Mechanismus ist
für alle DTD identisch, Sie müssen nur eine Liste der existierenden
Markierungen und einige ihrer Charakteristika angeben.

Ich stimme zu, dass dies weitere Dokumentation benötigt, aber es wird immer
noch als Beta betrachtet und ich hasse es, Zeug zu dokumentieren, dass sich
noch ändern kann oder wird.

=item *

Warnung: Die Unterstützung für DTDs ist noch recht experimentell. Ich habe
kein Referenzhandbuch gelesen, um die Definition jeder Markierung
herauszufinden. Ich habe die Makierungsdefinitionen zum Modul hinzugefügt,
bis es für einige Dokumente funktionierte, die ich im Netz fand. Falls Ihr
Dokument mehr Markierungen verwendet als meins, wird es nicht
funktionieren. Aber wie oben geschrieben, sollte das leicht zu beheben sein.

Ich habe DocBook nur mit der SAG (System Administrator Guide) getestet,
allerdings ist dieses Dokument sehr groß und sollte den Großteil der
DocBook-Spezialitäten verwenden.

Für DebianDoc habe ich einige der Handbücher vom DDP getestet, aber noch
nicht alle.

=item *

Im Falle von Dateieinbindungen werden Zeichenkettenreferenzen von Meldungen
in PO-Dateien (d.h. Zeilen der Art C<#: en/titletoc.sgml:9460>) falsch sein.

Dies rührt daher, dass die Datei vorbearbeitet wird, um die bedingten
Einbindungen (d.h. das C<E<lt>! [ %foo [> und C<]]E<gt>> Zeug) und einige
Entitäten (wie C<&version;>) vor B<onsgmls>(1) zu schützen, da ich sie
unverändert im automatisch erstellten Dokument bekommen möchte. Daher wird
eine temporäre Kopie der Eingabedatei angelegt und alle Änderungen werden
daran vorgenommen, bevor sie an B<onsgmls>(1) zur Auswertung übergeben wird.

Damit dies funktioniert, werden die Entitäten, die eine Dateieinbindung
durch den Inhalt der angegebenen Datei erbitten, ersetzt (so dass auch
geschützt werden kann, was in einer Unterdatei ist). Allerdings erfolgt
derzeit anschließend nichts, um die Referenzen zu schützen (d.h. Dateiname
und Zeilennummer). Mir ist nicht klar, was hier das beste Vorgehen ist.

=back

=head1 AUTOREN

Dieses Modul ist eine angepasste Version von Sgmlspl (SGML postprocessor for
the ONSGMLS parsers), für den galt:

 Copyright © 1995 David Megginson <dmeggins@aix1.uottawa.ca>

Die Anpassung für Po4a wurde erledigt durch:

 Denis Barbier <barbier@linuxfr.org>
 Martin Quinson (mquinson#debian.org)

=head1 URHEBERRECHT UND LIZENZ

 Copyright © 1995 David Megginson <dmeggins@aix1.uottawa.ca>.
 Copyright © 2002-2005 SPI, Inc.

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.
