NAME

       Locale::Po4a::AsciiDoc - konvertiert AsciiDoc-Dokumente von/in PO-Dateien

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.

VON DIESEM MODUL AKZEPTIERTE OPTIONEN

       Dies sind die Modul-spezifischen Optionen:

       definitions
           Der  Name  der  Datei,  die  die Definitionen für Po4a enthält, wie diese im Abschnitt 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 po4a: beginnen.

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

       macro
           leerzeichengetrennte Liste von Makrodefinitionen

       style
           leerzeichengetrennte Liste von Stildefinitionen

       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.

       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.

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

       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.

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

       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.

       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 yfm_paths und yfm_keys zusammen verwandt werden, werden Werte
           aufgenommen,  falls  sie  auf  mindestens eine der Optionen passen. Feldwerte werden immer übersetzt,
           außer die Option yfm_skip_array wird bereitgestellt.

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

       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 yfm_paths und 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 yfm_skip_array wird bereitgestellt.

ANPASSUNGEN IM DOKUMENT

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

       //po4a: macro Name[Attributliste]
           Dies  beschreibt  die  Parameter eines Macros im Detail. Name muss ein gültiger Makroname sein und er
           endet in einem Unterstrich, falls das Ziel übersetzt werden muss.

           Das Argument 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 Name ein Pluszeichen (+) 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.

       //po4a: style [Attributliste]
           Dies beschreibt im Detail, welche Atribute eines Stils übersetzt werden müssen.

           Das  Argument  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 (+) vorangestellt wird, dann wird die Attributliste als ganzes
           übersetzt. Es ist nicht notwendig, übersetzbare Attribute festzulegen.

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

       //po4a: entry Name
           Dies erklärt einen Attributeintrag als übersetzbar. Standardmäßig sind sie nicht übersetzbar.

STATUS DIESES MODULS

       Erfolgreich bei einigen einfachen AsciiDoc-Dateien getestet.

AUTOREN

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

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.

perl v5.38.2                                       2024-08-28                      LOCALE::PO4A::ASCIIDOC.3PM(1)