LOCALE::PO4A::ASCIIDOC.3PM(1) User Contributed Perl Documentation NAME Locale::Po4a::AsciiDoc - konvertiert AsciiDoc-Dokumente von/in PO-Dateien BESCHREIBUNG Das Projektziel von Po4a (PO fur alles) ist es, die Ubersetzung (und interessanter, die Wartung der Ubersetzung) zu vereinfachen, indem die Gettext-Werkzeuge auch fur Gebiete verwendet werden, wo diese nicht erwartet werden, wie Dokumentation. Locale::Po4a::AsciiDoc ist ein Modul, um bei der Ubersetzung 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 fur Po4a enthalt, wie diese im Abschnitt ANPASSUNGEN IM DOKUMENT beschrieben sind. Sie konnen diese Option verwenden, falls es nicht moglich ist, die Definitionen in das zu ubersetzende Dokument zu schreiben. In einer Definitionsdatei durfen die Zeilen nicht mit zwei Schragstrichen, sondern mussen direkt durch po4a: beginnen. entry leerzeichengetrennte Liste von Attributeintragen, die Sie ubersetzen mochten. Standardmassig sind keine Attributeintrage ubersetzbar. macro leerzeichengetrennte Liste von Makrodefinitionen style leerzeichengetrennte Liste von Stildefinitionen forcewrap Aktiviert automatischen Zeilenumbruch in wortlichen Blocken, selbst wenn das Ergebnis durch AsciiDoc-Formatierprogramme falsch interpretiert werden konnte. Standardmassig bricht Po4a die erstellten AsciiDoc-Dateien nicht um, da eine manuelle Uberprufung notwendig ist, um sicherzustellen, dass der Umbruch nicht die Formatierung andert. 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 fuhrt, dann wird der Eintrag in eine nummerierte Unterliste aufgeteilt. Um es noch schlimmer werden zu lassen, konnen nur die Leser der in der Ubersetzung verwandten Sprache die Situation uberprufen. * 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 fur 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 moglicherweise falsch formatierten Ausgaben fuhren. noimagetargets Standardmassig konnen die Ziele von Blockbildern ubersetzt werden, um die Moglichkeit zu schaffen, auf ubersetzte Inhalte zu verweisen. Dies kann durch Setzen dieser Option gestoppt werden. tablecells Diese Option ist ein Schalter, der Innerzell-Abtrennung in Zellinhalten ermoglicht. Die Abtrennung ist auf Zellinhalte begrenzt, ohne das Innere auszuwerten. compat Schaltet die Auswertregeln auf Kompatibilitat zu verschiedenen Werkzeugen um. Verfugbare Optionen sind >>asciidoc<< und >>asciidoctor<<. Asciidoctor hat strengere Auswertregeln, wie die Gleichheit der Langen von offnenden und schliessenden Blockbegrenzungen. nolinting Deaktiviert Linting-Meldungen. Wenn der Quellcode nicht fur eine klarere Dokumentenstruktur korrigiert werden kann, dann sind diese Meldungen zwecklos. cleanspaces Entfernt zusatzliche Leerzeichen aus Quellsegmenten im >>no-wrap<<-Modus. Dies ist nutzlich, wenn die Ubersetzungswerkzeuge empfindlich auf die Anzahl der Leerzeichen reagieren. yfm_keys Kommata-getrennte Liste der Schlussel, die fur das Ubersetzen in dem Abschnitt >>YAML FrontMatter<< verarbeitet werden. Alle anderen Schlussel werden ubersprungen. Schlussel werden abhangig von der Gross-/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 ubersetzt, ausser die Option yfm_skip_array wird bereitgestellt. yfm_skip_array Keine Feldwerte in dem Abschnitt >>YAML Front Matter<< ubersetzen. yfm_paths Kommata-getrennte Liste von Hash-Pfaden, die fur das Herausziehen in dem Abschnitt >>YAML Front Matter<< verarbeitet werden. Alle anderen Pfade werden ubersprungen. Pfade werden abhangig von der Gross-/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 zuruckgeliefert, ausser 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 gultiger Makroname sein und er endet in einem Unterstrich, falls das Ziel ubersetzt werden muss. Das Argument Attributliste ist eine kommatagetrennte Liste, die Informationen uber ubersetzbare Argumente enthalt. Diese Liste enthalt entweder Zahlen, um Positionsparameter zu definieren, oder benannte Attribute. Falls Name ein Pluszeichen (+) vorangestellt wird, dann wird das Makro und seine Argumente als ganzes ubersetzt. In diesem Fall ist es nicht notwendig, die Attributliste zu definieren, aber die Klammern mussen vorhanden sein. //po4a: style [Attributliste] Dies beschreibt im Detail, welche Atribute eines Stils ubersetzt werden mussen. Das Argument Attributliste ist eine kommatagetrennte Liste, die Informationen uber ubersetzbare Argumente enthalt. Diese Liste enthalt entweder Zahlen, um Positionsparameter zu definieren, oder benannte Attribute. Das erste Attribut ist der Name des Stils, er wird nicht ubersetzt. Falls dem Stilnamen ein Pluszeichen (+) vorangestellt wird, dann wird die Attributliste als ganzes ubersetzt. Es ist nicht notwendig, ubersetzbare Attribute festzulegen. Falls dem Stilnamen ein Minuszeichen (-) vorangestellt wird, dann wird dieses Attribut nicht ubersetzt. Falls ein Prozentzeichen (%) an den Stilnamen angehangt wird, dann wird der Stil wortwortlich verarbeitet. Die Zeilen in Absatzen oder Blocken mit diesem Stil werden in den PO-Dateien erhalten und die entsprechenden Eintrage werden als >>no-wrap<< markiert. //po4a: entry Name Dies erklart einen Attributeintrag als ubersetzbar. Standardmassig sind sie nicht ubersetzbar. STATUS DIESES MODULS Erfolgreich bei einigen einfachen AsciiDoc-Dateien getestet. AUTOREN Nicolas Francois Denis Barbier URHEBERRECHT UND LIZENZ Copyright (C) 2005-2008 Nicolas FRANCOIS . Copyright (C) 2012 Denis BARBIER . Copyright (C) 2017 Martin Quinson . Dieses Programm ist freie Software; Sie konnen es unter den Bedingungen der GPL v2.0 oder neuer (siehe die Datei COPYING) vertreiben und/oder verandern. perl v5.42.0 2025-11-22 LOCALE::PO4A::ASCIIDOC.3PM(1)