.\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "PO4A-TRANSLATE 1p" .TH PO4A-TRANSLATE 1p "2020-08-19" "Po4a-Werkzeuge" "Po4a-Werkzeuge" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" po4a\-translate \- konvertiert eine PO\-Datei zurück ins Dokumentationsformat .SH "ÜBERSICHT" .IX Header "ÜBERSICHT" \&\fBpo4a\-translate\fR \fB\-f\fR \fIfmt\fR \fB\-m\fR \fIMaster.dok\fR \fB\-p\fR \fI\s-1XX\s0.po\fR \fB\-l\fR \&\fI\s-1XX\s0.dok\fR .PP (\fI\s-1XX\s0.dok\fR ist die Ausgabe, alles andere sind Eingaben) .SH "BESCHREIBUNG" .IX Header "BESCHREIBUNG" Das Projektziel von Po4a (\s-1PO\s0 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. .PP Das Skript \fBpo4a\-translate\fR ist dafür zuständig, die Übersetzung (die in einer PO-Datei erfolgte) zurück in das Dokumentationsformat zu wandeln. Die bereitgestellte PO-Datei sollte die Übersetzung einer POT-Datei sein, die mittels \fBpo4a\-gettextize\fR\|(1) erstellt wurde. .SH "OPTIONEN" .IX Header "OPTIONEN" .IP "\fB\-f\fR, \fB\-\-format\fR" 4 .IX Item "-f, --format" Format der Dokumentation, mit der Sie arbeiten möchten. Verwenden Sie die Option \fB\-\-help\-format\fR, um eine Liste der verfügbaren Formate zu erhalten. .IP "\fB\-a\fR, \fB\-\-addendum\fR" 4 .IX Item "-a, --addendum" Fügt eine Datei zu der entstehenden Datei hinzu (um beispielsweise den Namen des Übersetzers oder einen Abschnitt »Über diese Übersetzung« hinzuzufügen). Die erste Zeile der einzufügenden Datei sollte eine PO4A\-Kopfzeile sein, die angibt, wo der Inhalt eingefügt werden soll (lesen Sie den Abschnitt \fB\s-1HOWTO:\s0 Wie wird zusätzlicher Text zu Übersetzungen hinzugefügt\fR in \fBpo4a\fR\|(7)). .IP "\fB\-A\fR, \fB\-\-addendum\-charset\fR" 4 .IX Item "-A, --addendum-charset" Zeichensatz der Addenda. Beachten Sie, dass alle Addenda im gleichen Zeichensatz vorliegen sollten. .IP "\fB\-m\fR, \fB\-\-master\fR" 4 .IX Item "-m, --master" Datei, die das zu übersetzende Master-Dokument enthält. .IP "\fB\-M\fR, \fB\-\-master\-charset\fR" 4 .IX Item "-M, --master-charset" Zeichensatz der Datei, die das zu übersetzende Dokument enthält. .IP "\fB\-l\fR, \fB\-\-localized\fR" 4 .IX Item "-l, --localized" Datei, in die das lokalisierte (übersetzte) Dokument geschrieben werden soll. .IP "\fB\-L\fR, \fB\-\-localized\-charset\fR" 4 .IX Item "-L, --localized-charset" Zeichensatz der Datei, die das lokalisierte Dokument enthält. .IP "\fB\-p\fR, \fB\-\-po\fR" 4 .IX Item "-p, --po" Datei, aus der der Nachrichtenkatalog gelesen werden soll. .IP "\fB\-o\fR, \fB\-\-option\fR" 4 .IX Item "-o, --option" Extraoption(en), die an die Formaterweiterung übergeben werden soll. Lesen Sie die Dokumentation jeder Erweiterung für weitere Informationen über die gültigen Optionen und ihre Bedeutungen. Beispielsweise könnten Sie dem AsciiDoc-Auswerter »\-o tablecells« übergeben, während der Text-Auswerter »\-o tabs=split« akzeptierte. .IP "\fB\-k\fR, \fB\-\-keep\fR" 4 .IX Item "-k, --keep" Minimaler Schwellwert in Prozent, ab der die übersetzte Datei erhalten (d.h. geschrieben) wird, standardmäßig 80. D.h., standardmäßig müssen Dateien zu 80% übersetzt sein, um geschrieben zu werden. .IP "\fB\-w\fR, \fB\-\-width\fR" 4 .IX Item "-w, --width" Spalte, an der die entstehende Datei umgebrochen werden soll. .IP "\fB\-h\fR, \fB\-\-help\fR" 4 .IX Item "-h, --help" zeigt eine kurze Hilfemeldung an .IP "\fB\-\-help\-format\fR" 4 .IX Item "--help-format" die von Po4a verstandenen Dokumentationsformate auflisten .IP "\fB\-V\fR, \fB\-\-version\fR" 4 .IX Item "-V, --version" zeigt die Version des Skripts und beendet sich .IP "\fB\-v\fR, \fB\-\-verbose\fR" 4 .IX Item "-v, --verbose" Erhöhen der Ausführlichkeit des Programms .IP "\fB\-d\fR, \fB\-\-debug\fR" 4 .IX Item "-d, --debug" Fehlersuch\- (Debug\-)Informationen ausgeben .IP "\fB\-\-porefs\fR \fITyp\fR[,\fBwrap\fR|\fBnowrap\fR]" 4 .IX Item "--porefs Typ[,wrap|nowrap]" Gibt das Referenzformat an. Das Argument \fITyp\fR kann entweder \fBnever\fR (keine Referenz erzeugen), \fBfile\fR (nur die Datei ohne Zeilenzahlen festlegen), \fBcounter\fR (alle Zeilennummern durch einen ansteigenden Zähler ersetzen) oder \fBfull\fR (komplette Referenzen einbinden) sein. Die Vorgabe ist »full«. .Sp Das Argument kann von einem Komma und entweder dem Schlüsselwort \fBwrap\fR oder \fBnowrap\fR gefolgt werden. Referenzen werden standardmäßig auf eine einzelne Zeile geschrieben. Die Option \fBwrap\fR bricht Referenzen über mehre Zeilen um, um die \fBgettext\fR (\fBxgettext\fR und \fBmsgmerge\fR) nachzuahmen. Diese Option wird in zukünftigen Veröffentlichungen die Vorgabe werden, da sie vernünftiger ist. Die Option \fBnowrap\fR ist für Benutzer, die das alte Verhalten beibehalten möchten, verfügbar. .IP "\fB\-\-wrap\-po\fR \fBno\fR|\fBnewlines\fR|\fIZahl\fR (Vorgabe: 76)" 4 .IX Item "--wrap-po no|newlines|Zahl (Vorgabe: 76)" Legt fest, wie die PO-Datei umgebrochen werden soll. Dies ermöglicht die Auswahl zwischen Dateien, die schön umgebrochen sind aber zu GIT-Konflikten führen können oder Dateien, die leichter automatisch zu handhaben, aber schwerer für Menschen zu lesen sind. .Sp Aus kosmetischen Gründen hat die Gettext-Programmsammlung in der Vergangenheit PO-Dateien in der 77.Spalte umgebrochen. Diese Option legt das Verhalten von Po4a fest. Falls auf einen numerischen Wert gesetzt, wird Po4a die PO-Datei nach dieser Spalte und nach Zeilenumbrüchen im Inhalt umbrechen. Falls auf \fBnewlines\fR gesetzt, wird Po4a die msgid und msgstr nur nach Zeilenumbrüchen im Inhalt auftrennen. Falls auf \fBno\fR gesetzt, wird Po4a die PO-Datei überhaupt nicht umbrechen. Der Umbruch der Referenzkommentare wird mit der Option \fB\-\-porefs\fR gesteuert. .Sp Beachten Sie, dass diese Option keine Auswirkung darauf hat, wie msgid und msgstr umgebrochen werden, d.h. wie Zeilenumbrüche zu dem Inhalt dieser Zeilen hinzugefügt werden. .SH "Inhalte (neben den Übersetzungen) zu erstellten Dateien hinzufügen" .IX Header "Inhalte (neben den Übersetzungen) zu erstellten Dateien hinzufügen" Um neben der eigentlichen Übersetzung zusätzliche Inhalte zum erstellten Dokument hinzuzufügen (wie den Namen des Übersetzers oder einen Abschnitt »Über diese Übersetzung«) sollten Sie die Option \fB\-\-addendum\fR verwenden. .PP Die erste Zeile des Addendums muss eine Kopfzeile sein, die angibt, wo im Dokument das Addendum eingefügt werden soll (dies kann vor oder nach einem bestimmten Teil des Dokuments sein). Der Rest der Datei wird unverändert zu der entstehenden Datei ohne weitere Bearbeitung hinzugefügt. .PP Beachten Sie, dass Po4a die gesamte Übersetzung verwerfen wird, falls eine der angegebenen Dateien nicht hinzugefügt werden konnte (da die fehlende Datei Informationen über den Autor enthalten könnte und somit den Benutzer davon abhalten könnte, Fehler in der Übersetzung zu berichten). .PP Diese Kopfzeile hat eine ziemlich starre Syntax. Für weitere Informationen zur Nutzung dieser Funktionalität und deren Funktionsweise lesen Sie die Handbuchseite \fBpo4a\fR\|(7). .SH "SIEHE AUCH" .IX Header "SIEHE AUCH" \&\fBpo4a\-gettextize\fR\|(1), \fBpo4a\-normalize\fR\|(1), \fBpo4a\-updatepo\fR\|(1), \fBpo4a\fR\|(7) .SH "AUTOREN" .IX Header "AUTOREN" .Vb 3 \& Denis Barbier \& Nicolas François \& Martin Quinson (mquinson#debian.org) .Ve .SH "URHEBERRECHT UND LIZENZ" .IX Header "URHEBERRECHT UND LIZENZ" Copyright 2002\-2020 \s-1SPI,\s0 Inc. .PP Dieses Programm ist freie Software; Sie können es unter den Bedingungen der \&\s-1GPL\s0 (siehe die Datei \s-1COPYING\s0) vertreiben und/oder verändern.