LOCALE::PO4A::DOCBOOK.3PM(1)               User Contributed Perl Documentation


NAME
       Locale::Po4a::Docbook - konvertiert DocBook-XML-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::Docbook ist ein Modul, um Ihnen bei der Ubersetzung von
       DocBook-XML-Dokumenten in andere [naturliche] Sprachen zu helfen.

STATUS DIESES MODULS
       Dieses Modul ist voll funktional, da es vom Modul Locale::Po4a::Xml
       abhangt. Es definiert nur die ubersetzbaren Markierungen (>>Tags<<) und
       Attribute.

       Das einzige bekannte Problem ist, dass es noch nicht mit Entitaten
       umgehen kann. Hierzu gehoren auch die Dateieinbindungsentitaten.
       Allerdings konnen Sie die meisten solcher Dateien einzeln ubersetzten
       (ausser den typischen Entitatendateien) und im Allgemeinen ist es auch
       besser, sie einzeln zu warten.

AUSSERKRAFTSETZEN DES VORGABEVERHALTENS MIT BEFEHLSZEILENOPTIONEN
       Das Vorgabeverhalten der vom System bereitgestellten Module ist auf
       einen sicheren Wert eingestellt.

       Beispielsweise ist die Vorgabe fur die Markierung <author>, dass sie
       unter <para> erscheinen soll. Aber Sie konnten es nur unter <bookinfo>
       verwenden. In diesem Fall mochten Sie es vielleicht unabhangig fur
       jeden Autor ubersetzen.

       Falls Sie das Vorgabeverhalten des XML-Moduls und seiner abgeleiteten
       Module nicht mogen, konnen Sie Befehlszeilenoptionen verwenden, um ihr
       Verhalten zu verandern. Beispielsweise konnen Sie Folgendes zu der
       Po4a-Konfigurationsdatei hinzuufugen:

         opt:"-k 0 -o nodefault=\"<bookinfo> <author>\" \
                   -o break=\"<bookinfo> <author>\" \
                   -o untranslated=\"<bookinfo>\" \
                   -o translated=\"<author>\""

       Dies setzt das Vorgabeverhalten fur <bookinfo> und <author> ausser
       Kraft, setzt, dass <bookinfo> und <author> den Eingabedatenstrom bei
       diesen Merkierungen unterbrichen, setzt, dass <bookinfo> nicht seinen
       markierten Inhalt ubersetzt und setzt, dass <author> seinen markierten
       Inhalt ubersetzt.

SIEHE AUCH
       Locale::Po4a::TransTractor(3pm), Locale::Po4a::Xml(3pm), po4a(7)

AUTOREN
        Jordi Vilalta <jvprat@gmail.com>

URHEBERRECHT UND LIZENZ
        Copyright (C) 2004 Jordi Vilalta  <jvprat@gmail.com>
        Copyright (C) 2007-2009 Nicolas Francois <nicolas.francois@centraliens.net>

       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.38.2                      2024-06-26      LOCALE::PO4A::DOCBOOK.3PM(1)