DOKK / manpages / debian 10 / po4a / Locale::Po4a::AsciiDoc.3pm.de
Locale::Po4a::AsciiDoc(3pm) Po4a-Werkzeuge Locale::Po4a::AsciiDoc(3pm)

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

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.

Dies sind die Modul-spezifischen Optionen:

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.

leerzeichengetrennte Liste von Attributeinträgen, die Sie übersetzen möchten. Standardmäßig sind keine Attributeinträge übersetzbar.
leerzeichengetrennte Liste von Makrodefinitionen
leerzeichengetrennte Liste von Stildefinitionen
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.

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 erlaubt es, die Parameter eines Macro im Detail zu beschreiben. 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 erlaubt es im Detail zu beschreiben, welche Atrribute 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.

Erfolgreich bei einigen einfachen AsciiDoc-Dateien getestet.

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


 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 (siehe die Datei COPYING) vertreiben und/oder verändern.

2018-12-09 Po4a-Werkzeuge