
        *****************************************************
        *           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::AsciiDoc - konvertiert AsciiDoc-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::AsciiDoc ist ein Modul, um bei der Übersetzung von
Dokumentation im AsciiDoc-Format zu helfen.

=head1 VON DIESEM MODUL AKZEPTIERTE OPTIONEN

Dies sind die Modul-spezifischen Optionen:

=over

=item B<definitions>

Der Name der Datei, die die Definitionen für Po4a enthält, wie diese im
Abschnitt B<ANPASSUNGEN IM DOKUMENT> beschrieben sind. Sie können diese
Option verwenden, falls es nicht möglich ist, die Definitionen in das zu
übersetzende Dokument zu schreiben.

In einer Definitionsdatei dürfen die Zeilen nicht mit zwei Schrägstrichen,
sondern müssen direkt durch B<po4a:> beginnen.

=item B<entry>

leerzeichengetrennte Liste von Attributeinträgen, die Sie übersetzen
möchten. Standardmäßig sind keine Attributeinträge übersetzbar.

=item B<macro>

leerzeichengetrennte Liste von Makrodefinitionen

=item B<style>

leerzeichengetrennte Liste von Stildefinitionen

=item B<forcewrap>

Aktiviert automatischen Zeilenumbruch in wörtlichen Blöcken, selbst wenn das
Ergebnis durch AsciiDoc-Formatierprogramme falsch interpretiert werden
könnte.

Standardmäßig bricht Po4a die erstellten AsciiDoc-Dateien nicht um, da eine
manuelle Überprüfung notwendig ist, um sicherzustellen, dass der Umbruch
nicht die Formatierung ändert. Betrachten Sie beispielsweise die folgende
Liste:

 * ein langer Satz, der auf eine Zahl 1 endet. Ein zweiter Satz.

Falls der Umbruch zu der folgenden Darstellung führt, dann wird der Eintrag
in eine nummerierte Unterliste aufgeteilt. Um es noch schlimmer werden zu
lassen, können nur die Leser der in der Übersetzung verwandten Sprache die
Situation überprüfen.

 * eine langer Satz, der auf einer Zahl
   1 endet. Ein zweiter Satz.

Beachten Sie, dass es kein Problem ist, dass die von Po4a erstellten Dateien
nicht umgebrochen werden, da diese Dateien für die automatische Verarbeitung
gedacht sind. Sie sollten sowieso nicht als Eingabedatei verstanden werden.

Mit dieser Option wird Po4a besser aussehende AsciiDoc-Dateien erstellen,
aber sie kann zu möglicherweise falsch formatierten Ausgaben führen.

=item B<noimagetargets>

Standardmäßig können die Ziele von Blockbildern übersetzt werden, um die
Möglichkeit zu schaffen, auf übersetzte Inhalte zu verweisen. Dies kann
durch Setzen dieser Option gestoppt werden.

=item B<tablecells>

Diese Option ist ein Schalter, der Innerzell-Abtrennung in Zellinhalten
ermöglicht. Die Abtrennung ist auf Zellinhalte begrenzt, ohne das Innere
auszuwerten.

=item B<compat>

Schaltet die Auswertregeln auf Kompatibilität zu verschiedenen Werkzeugen
um. Verfügbare Optionen sind »asciidoc« und »asciidoctor«. Asciidoctor hat
strengere Auswertregeln, wie die Gleichheit der Längen von öffnenden und
schließenden Blockbegrenzungen.

=item B<nolinting>

Deaktiviert Linting-Meldungen. Wenn der Quellcode nicht für eine klarere
Dokumentenstruktur korrigiert werden kann, dann sind diese Meldungen
zwecklos.

=item B<cleanspaces>

Entfernt zusätzliche Leerzeichen aus Quellsegmenten im »no-wrap«-Modus. Dies
ist nützlich, wenn die Übersetzungswerkzeuge empfindlich auf die Anzahl der
Leerzeichen reagieren.

=item B<yfm_keys>

Kommata-getrennte Liste der Schlüssel, die für das Übersetzen in dem
Abschnitt »YAML FrontMatter« verarbeitet werden. Alle anderen Schlüssel
werden übersprungen. Schlüssel werden abhängig von der Groß-/Kleinschreibung
verglichen. Falls B<yfm_paths> und B<yfm_keys> zusammen verwandt werden,
werden Werte aufgenommen, falls sie auf mindestens eine der Optionen
passen. Feldwerte werden immer übersetzt, außer die Option B<yfm_skip_array>
wird bereitgestellt.

=item B<yfm_skip_array>

Keine Feldwerte in dem Abschnitt »YAML Front Matter« übersetzen.

=item B<yfm_paths>

Kommata-getrennte Liste von Hash-Pfaden, die für das Herausziehen in dem
Abschnitt »YAML Front Matter« verarbeitet werden. Alle anderen Pfade werden
übersprungen. Pfade werden abhängig von der Groß-/Kleinschreibung
verglichen. Falls B<yfm_paths> und B<yfm_keys> zusammen verwandt werden,
werden Werte aufgenommen, falls sie auf mindestens eine der Optionen
passen. Feldwerte werden immer zurückgeliefert, außer die Option
B<yfm_skip_array> wird bereitgestellt.

=back

=head1 ANPASSUNGEN IM DOKUMENT

Das AsciiDoc-Modul kann durch Zeilen, die mit B<% po4a:> beginnen, angepasst
werden. Diese Zeilen werden vom Parser als Befehle interpretiert. Die
folgenden Befehle werden erkannt:

=over 4

=item B<//po4a: macro >I<Name>B<[>I<Attributliste>B<]>

Dies beschreibt die Parameter eines I<Macro>s im Detail. I<Name> muss ein
gültiger Makroname sein und er endet in einem Unterstrich, falls das Ziel
übersetzt werden muss.

Das Argument I<Attributliste> ist eine kommatagetrennte Liste, die
Informationen über übersetzbare Argumente enthält. Diese Liste enthält
entweder Zahlen, um Positionsparameter zu definieren, oder benannte
Attribute.

Falls I<Name> ein Pluszeichen (B<+>) vorangestellt wird, dann wird das Makro
und seine Argumente als ganzes übersetzt. In diesem Fall ist es nicht
notwendig, die Attributliste zu definieren, aber die Klammern müssen
vorhanden sein.

=item B<//po4a: style >B<[>I<Attributliste>B<]>

Dies beschreibt im Detail, welche Atribute eines Stils übersetzt werden
müssen.

Das Argument I<Attributliste> ist eine kommatagetrennte Liste, die
Informationen über übersetzbare Argumente enthält. Diese Liste enthält
entweder Zahlen, um Positionsparameter zu definieren, oder benannte
Attribute. Das erste Attribut ist der Name des Stils, er wird nicht
übersetzt.

Falls dem Stilnamen ein Pluszeichen (B<+>) vorangestellt wird, dann wird die
Attributliste als ganzes übersetzt. Es ist nicht notwendig, übersetzbare
Attribute festzulegen.

Falls dem Stilnamen ein Minuszeichen (B<->) vorangestellt wird, dann wird
dieses Attribut nicht übersetzt.

Falls ein Prozentzeichen (B<%>) an den Stilnamen angehängt wird, dann wird
der Stil wortwörtlich verarbeitet. Die Zeilen in Absätzen oder Blöcken mit
diesem Stil werden in den PO-Dateien erhalten und die entsprechenden
Einträge werden als »no-wrap« markiert.

=item B<//po4a: entry >I<Name>

Dies erklärt einen Attributeintrag als übersetzbar. Standardmäßig sind sie
nicht übersetzbar.

=back

=head1 STATUS DIESES MODULS

Erfolgreich bei einigen einfachen AsciiDoc-Dateien getestet.

=head1 AUTOREN

 Nicolas François <nicolas.francois@centraliens.net>
 Denis Barbier <barbier@linuxfr.org>

=head1 URHEBERRECHT UND LIZENZ

 Copyright © 2005-2008 Nicolas FRANÇOIS <nicolas.francois@centraliens.net>.
 Copyright © 2012 Denis BARBIER <barbier@linuxfr.org>.
 Copyright © 2017 Martin Quinson <mquinson#debian.org>.

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.
