POD2TEXI(1)

BEZEICHNUNG
pod2texi - Pod zu Texinfo umwandeln

ÜBERSICHT
 pod2texi [OPTION] … POD …

BESCHREIBUNG
Übersetzt Pod-Datei(en) in Texinfo. Es gibt zwei grundlegende Arbeitsmodi. Im ersten Modus (die Vorgabe) wird jede Pod-Datei in ein eigenständiges Texinfo-Handbuch übersetzt.

Im zweiten Modus, falls --base-level auf einen Wert größer als 0 gesetzt ist, wird jede Pod-Datei in eine für @include geeignete Datei übersetzt. Außerdem wird eine weitere Datei mit einem Hauptmenü und allen @includes erstellt.

OPTIONEN

--appendix-sections
    verwendet Anhang-Abschnittsbefehle (@appendix, …) anstelle der vorgegebenen nummerierten @-Abschnittsbefehle von Texinfo (@chapter, @section, …).

--base-level=ZAHL|NAME
    legt die Ebene der »head1«-Befehle fest. Diese kann eine Ganzzahl oder ein Texinfo-Abschnittsbefehl sein (ohne das »@«: 1 entspricht der @chapter/@unnumbered-Ebene, 2 der @section-Ebene und so weiter. Die Voreinstellung ist 0, wodurch die »head1«-Befehle immer noch als Kapitel ausgegeben werden, aber die Ausgabe als eigenständiges Handbuch zusammengestellt wird.

    Falls die Ebene nicht 0 ist, wird aus der Pod-Datei ein Fragment eines Texinfo-Handbuchs erstellt, das sich als @include verwenden lässt. In diesem Fall besitzt jede Pod-Datei einen zusätzlichen Abschnittsbefehl, der die gesamte Datei abdeckt, eine Ebene über dem --base-level-Wert. Um jede Pod-Datei als Kapitel eines großen Handbuchs zu definieren, sollten Sie »section« als Basisebene verwenden.

    Ein Beispiel dafür, wie Texinfo aus der Perl-Dokumentation selbst erstellt wird, finden Sie in »contrib/perldoc-all« in der Quelldistribution von Textinfo.

--debug=ZAHL
    setzt die Debugging-Stufe auf die angegebene ZAHL.

--generate-setfilename
    erstellt eine @setfilename-Zeile für freistehende Handbücher. Kann mit --no-generate-setfilename verneint werden. Wird ignoriert, falls --base-level nicht 0 ist.

--headings-as-sections
    verwendet Überschrift-Befehle (@heading, …) anstelle der vorgegebenen nummerierten @-Abschnittsbefehle von Texinfo (@chapter, @section, …). Der Abschnittsbefehl, der die gesamte Dateiausgabe für jede Pod-Datei abdeckt, sofern --base-level nicht 0 ist, ist ein nummerierter Befehl.

--help
    zeigt einen Hilfetext an und beendet das Programm.

--menus
    gibt Knotenmenüs aus. Falls ein Haupthandbuch existiert, wird dessen Knotenmenü der obersten Ebene stets ausgegeben, da ein Menü der obersten Ebene erzeugt wird. Andere Knotenmenüs werden standardmäßig nicht ausgegeben.

--outdir=NAME
    legt erstellte Texinfo-Dateien im Verzeichnis NAME ab, falls es ein Haupthandbuch mit Einbindungsdateien gibt (wovon jede einer Pod-Eingabedatei entspricht). Die Vorgabe basiert auf --subdir.

--output=NAME
    legt den Namen des ersten Handbuchs fest, oder den Namen des Haupthandbuchs, falls es ein solches gibt. Standardmäßig wird in die Standardausgabe geschrieben.

--no-section-nodes
    verwendet Anker anstatt Knoten für Abschnitte.

--no-fill-section-gaps
    füllt die Abschnittslücken nicht mit leeren @unnumbered-Dateien. Für gewöhnlich ist es gut, die Abschnittshierarchie intakt zu halten.

--preamble=ZEICHENKETTE
    fügt die angegebene ZEICHENKETTE als obersten Textbaustein vor Menüs und Einbindungen ein. Falls die ZEICHENKETTE als "-" angegeben ist, wird der oberste Textbaustein aus der Standardeingabe gelesen. Der oberste Textbaustein ist ein minimaler Anfang für ein Texinfo-Dokument.

--setfilename=ZEICHENKETTE
    fügt die angegebene ZEICHENKETTE als obersten Textbaustein vor Menüs und Einbindungen für @setfilename für das Haupthandbuch ein, falls --base-level nicht auf 0 gesetzt ist. Dies wird ignoriert, falls --base-level 0 ist. Standardmäßig wird kein @setfilename für das Haupthandbuch ausgegeben.

--subdir=NAME
    bindet Einbindungsdateien aus NAME ein, falls es ein Haupthandbuch mit Einbindungsdateien gibt (wovon jede einer Pod-Eingabedatei entspricht).

    Falls --outdir gestzt ist, sollte NAME im Allgemeinen auf das relative Verzeichnis zwischen dem Haupthandbuch und dem Argument --outdir gesetzt werden.

--unnumbered-sections
    verwendet unnummerierte Abschnittsbefehle (@unnumbered, …) anstelle der vorgegebenen nummerierten @-Abschnittsbefehle von Texinfo (@chapter, @section, …).

--top=TOP
    legt den Namen des @top-Elements für das Haupthandbuch fest. Dies darf Texinfo-Code enthalten.

--version
    zeigt Versionsinformationen an und beendet das Programm.

SIEHE AUCH
Pod::Simple::Texinfo. perlpod. Das Texinfo-Handbuch. Homepage von GNU Texinfo: <https://www.gnu.org/software/texinfo/>

COPYRIGHT und LIZENZ
Copyright 2012-2024 Free Software Foundation, Inc.

Dieses Programm ist freie Software; Sie können es unter den Bedingungen der GNU General Public License weitergeben und/oder verändern, so wie sie von der Free Software Foundation veröffentlicht wurde; entweder in Version 3 der Lizenz oder (nach Ihrem Ermessen) in jeder späteren Version.

Es gibt KEINERLEI GARANTIEN, soweit gesetzlich zulässig.

AUTOR
Patrice Dumas <bug-texinfo@gnu.org>.

ÜBERSETZUNG
Die deutsche Übersetzung dieser Handbuchseite wurde von Mario Blättermann <mario.blaettermann@gmail.com> und Helge Kreutzmann <debian@helgefjell.de> erstellt.

Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 (https://www.gnu.org/licenses/gpl-3.0.html) oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.

Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Übersetzer: debian-l10n-german@lists.debian.org.