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

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

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

       Dieses Programm ist freie Software; Sie können es unter den Bedingungen der GPL (siehe die
       Datei COPYING) vertreiben und/oder verändern.