Alle unterstützten Formate in allen unterstützten Kombinationen können in einer einzigen Konfigurationsdatei po4a-build.conf und mit einem einzigen Aufruf von "po4a-build" verwandt werden. Sie können sich aber auch dafür entscheiden, die po/-Verzeichnisse zu trennen und eine einzelne Konfigurationsdatei für jeden Aufruf zu verwenden. (Rufen Sie "po4a-build -f DATEI" für jede Konfigurationsdatei auf)
Beachten Sie, dass po4a-build zwar Unterstützung für das Hinzufügen von Gettext-Unterstützung zur Übersetzung von Skriptausgabenachrichten enthält, allerdings po4a-build.conf keinen Einfluss auf solche Übersetzungen hat. po4a-build.conf ist nur für die Übersetzung von statischen Inhalten wie Handbuchseiten zuständig.
Für Informationen über die Unterstützung der Übersetzung von Nachrichten zur Programmlaufzeit durch po4a-build lesen Sie po4a-runtime(7).
Handbuchseiten werden mit der standardmäßigen Unterstützung in Docbook-xsl gebaut - das zu verwendende Stylesheet kann mit der "XSLFILE"-Einstellung in der Konfigurationsdatei "po4a-build" überschrieben werden.
Verwenden Sie "PODFILE" für Abschnitt 1, "PODMODULES" für Abschnitt 3, "POD5FILES" für Abschnitt 5 und "POD7FILES" für Abschnitt 7.
Für Inhalte in den Abschnitten 5 oder 7 (wo oft ein Dateiname benötigt wird, der auch für Inhalte in Abschnitt 1 verwandt wird) wird, wenn der Dateiname »5« oder »7« als Teil des Dateinamens enthält, diese Nummer (und alle Dateinamenerweiterungen) automatisch entfernt.
Wird z.B. /usr/share/man/man7/po4a.7.gz vorbereitet:
# POD-Dateien für Abschnitt 7 POD7FILES="doc/po4a.7.pod"
Alle Inhalte nach einem »#« werden ignoriert.
Jeder Wert, der immer leer wäre, kann aus der Datei entfallen.
Einige Konfigurationsfelder müssen angegeben werden - po4a-build könnte im Nichts enden, falls erforderliche Felder leer sind.
Name und Ort der (temporären) "po4a"-Konfigurationsdatei, die "po4a-build" erstellen und verwalten wird. Diese Datei muss nicht in Ihrem Versionskontrollsystem gepflegt werden und kann während der Paketerstellung problemlos aufgeräumt werden.
# Name und Ort der Konfigurationsdatei CONFIG="_build/po4a.config"
Verzeichnis, das die PO-Dateien für ALLE Übersetzungen enthält, die von dieser Konfigurationsdatei verarbeitet werden. Alle Zeichenketten werden in eine POT-Datei in diesem Verzeichnis zusammengeführt und alle PO-Dateien werden mit dieser POT-Datei zusammengeführt. »KEEP«-Schwellwerte (siehe unten) werden auf alle Zeichenketten von allen in dieser Datei angegebenen Eingabedateien und allen PO-Dateien in diesem Verzeichnis angewandt. Das Verzeichnis muss nicht »po« heißen. Bitte beachten Sie allerdings, dass einige Statistikwerkzeuge erwarten, dass der Name »po« lauten sollte, daher wird empfohlen, diesen Namen beizubehalten.
# PO-Verzeichnis für Handbuchseiten/Dokumentation PODIR="po/pod"
Pfad zur POT-Datei (relativ zu der Lage dieser Konfigurationsdatei), die durch "po4a-build" für diese Übersetzung erstellt, gewartet und aktualisiert wird.
# POT-Dateipfad POTFILE="po/pod/po4a-pod.pot"
Basisverzeichnis zum Schreiben der übersetzten Inhalte.
# Basisverzeichnis für erstellte Dateien, z.B. dok BASEDIR="_build"
Selbst falls nur ein Paket gebaut wird, wird mindestens ein Wert hier benötigt.
Die Zeichenkette ist beliebig, besteht aber typischerweise aus dem Paketnamen. Erstellte Inhalte werden dann in Unterverzeichnissen von BASEDIR/BINARIES gespeichert:
_build/po4a/man/man1/foo.1
Falls das Paket mehr als ein Binärpaket baut (d.h. ein Quellpaket und mehrere .deb- oder .rpm-Dateien), kann dieses Feld dabei helfen, Inhalte für jedes Ziel abzugrenzen und damit die Automatisierung des Bauprozesses zu erleichtern.
Zeichenketten mit Leerzeichen trennen.
# Binärpakete, die erstellte Handbuchseiten enthalten werden BINARIES="po4a"
Für vollständige Kontrolle über dieses Verhalten, beachten Sie sorgfältig, welche Dateien welcher Konfigurationsdatei po4a-build.conf zugeordnet sind.
Beachten Sie, dass viele Dateien in einer POT-Datei für Übersetzer bequemer sind, insbesondere falls Dateien über gemeinsame Zeichenketten verfügen. Andersherum sind POT-Dateien mit tausenden von langen Zeichenketten für Übersetzer einschüchternd, woraus lange Perioden mit eingefrorenen Zeichenketten resultieren.
# minimaler Schwellwert, ab dem Übersetzungen beibehalten werden sollen KEEP=
Es ist übliche Praxis, mehrere XML-Dateien in einem Buch zusammenzustellen, um ein Inhaltsverzeichnis usw. bereitzustellen. Falls das Buch auch Dateien enthält, die in XMLMAN3 angegeben sind, dann geben Sie nur die XML-Dateien für Abschnitt 1 hier an, nicht das Buch selbst. Falls das Buch nur Inhalte für diesen Abschnitt enthält, geben Sie das Buch hier an.
# DocBook-XML-Dateien für Abschnitt 1 XMLMAN1="po4a-build.xml po4aman-display-po.xml po4apod-display-po.xml"
Es ist übliche Praxis, mehrere XML-Dateien in einem Buch zusammenzustellen, um ein Inhaltsverzeichnis usw. bereitzustellen. Falls das Buch auch Dateien enthält, die in XMLMAN1 angegeben sind, dann geben Sie nur die XML-Dateien für Abschnitt 3 hier an, nicht das Buch selbst. Falls das Buch nur Inhalte für diesen Abschnitt enthält, geben Sie das Buch hier an.
# DocBook-XML-Dateien für Abschnitt 3 XMLMAN3=""
Muss angegeben werden, falls XMLMAN1 oder XMLMAN3 verwandt wird. Pfade sind relativ zum Ort der Konfigurationsdatei.
# Ort der XML-Dateien XMLDIR="share/doc/"
Falls XMLMAN1 oder XMLMAN3 ein Wert gegeben wird, muss hier auch ein Wert angegeben werden.
# Binärpakete, die DocBook-XML & xsltproc verwenden XMLPACKAGES="po4a"
# Muster zum Finden der .docbook-Dateien DOCBOOKDIR=""
# XSL-Datei für die Verwendung mit DocBook-XML XSLFILE="http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl"
# POD-Dateien für Abschnitt 1 PODFILE="po4a po4a-gettextize po4a-normalize scripts/msguntypot"
# POD-Dateien für Abschnitt 3 - Modulnamen aus dem Pfad neu erstellt PODMODULES="lib/Locale/Po4a/*.pm"
Für Inhalte in den Abschnitten 5 oder 7 (wo oft ein Dateiname benötigt wird, der auch für Inhalte in Abschnitt 1 verwandt wird) wird, wenn der Dateiname »5« oder »7« als Teil des Dateinamens enthält, diese Nummer (und alle Dateinamenerweiterungen) automatisch entfernt.
# POD-Dateien für Abschnitt 5 POD5FILES="doc/po4a-build.conf.5.pod"
Für Inhalte in den Abschnitten 5 oder 7 (wo oft ein Dateiname benötigt wird, der auch für Inhalte in Abschnitt 1 verwandt wird) wird, wenn der Dateiname »5« oder »7« als Teil des Dateinamens enthält, diese Nummer (und alle Dateinamenerweiterungen) automatisch entfernt.
# POD-Dateien für Abschnitt 7 POD7FILES="doc/po4a.7.pod"
# POD-verwendende Binärpakete PODPACKAGES="po4a"
# HTML-Ausgabe (Unterverzeichnis von BASEDIR) HTMLDIR=""
# HTML-DocBook-Datei HTMLFILE=""
# für HTML zu verwendende XSL-Datei HTMLXSL="http://docbook.sourceforge.net/release/xsl/current/html/chunk.xsl"
Neil Williams <linux@codehelp.co.uk>