db2x_manxml – Online in der Cloud

PROGRAMM:

NAME/FUNKTION

db2x_manxml – Manpages aus Man-XML erstellen

ZUSAMMENFASSUNG

db2x_manxml [Optionen] [xml-Dokument]

BESCHREIBUNG

db2x_manxml Konvertiert ein Man-XML-Dokument in eine oder mehrere Manpages. Sie sind eingeschrieben
das aktuelle Verzeichnis.

If xml-Dokument nicht angegeben ist, wird das zu konvertierende Dokument aus der Standardeingabe gelesen.

OPTIONAL

--encoding=Codierung
Wählen Sie die für die Ausgabedateien verwendete Zeichencodierung aus. Die verfügbaren Kodierungen
sind die von iconv(1). Die Standardcodierung ist us-ascii.

Die XML-Quelle kann Zeichen enthalten, die in der Kodierung nicht darstellbar sind
die Sie auswählen; In diesem Fall wird das Programm während der Verarbeitung ausfallen, und Sie
sollte eine andere Kodierung wählen. (Dies passiert garantiert nicht mit Unicode
Codierung wie UTF-8, aber leider kann nicht jeder Unicode verarbeiten
Texte.)

Wenn Sie die GNU-Version von . verwenden iconv(1), Sie können //TRANSLIT an das Ende von anhängen
der Codierungsname, um Transliterationen aller nicht konvertierbaren Zeichen in zu versuchen
die Ausgabe. Beachten Sie jedoch, dass die wirklich inkonvertierbaren Zeichen sein werden
in ein weiteres dieser verdammten Fragezeichen verwandelt. (Hast du das nicht satt?)

Das Suffix //TRANSLIT, das auf eine Unicode-Codierung angewendet wird — insbesondere
utf-8//TRANSLIT — bedeutet, dass die Ausgabedateien in Unicode bleiben sollen, aber Markup-
Level-Zeichenübersetzungen mit utf8trans sind noch zu erledigen. Also in den meisten
Fälle, ein englischsprachiges Dokument, konvertiert mit --encoding=utf-8//TRANSLIT
wird tatsächlich als US-ASCII-Dokument enden, aber alle nicht übersetzbaren Zeichen werden
bleiben als UTF-8 ohne jegliche Vorwarnung. (Hinweis: Genau genommen ist dies
nicht „Transliteration“.) Diese Konvertierungsmethode ist ein Kompromiss gegenüber strikten
--encoding=us-ascii Verarbeitung, die abgebrochen wird, wenn unübersetzbare Zeichen enthalten sind
angetroffen.

Beachten Sie, dass man-Seiten und Texinfo-Dokumente in Nicht-ASCII-Kodierungen (einschließlich UTF-8)
möglicherweise nicht auf ältere (nicht-internationalisierte) Systeme übertragbar, weshalb die
Der Standardwert für diese Option ist us-ascii.

Um jegliche automatische Zeichenzuordnung oder Codierungskonvertierung zu unterdrücken, übergeben Sie
die Option --encoding=utf-8.

--list-Dateien
Schreiben Sie eine Liste aller Ausgabedateien in die Standardausgabe, zusätzlich zur normalen
Verarbeitung.

--output-dir=dir
Geben Sie das Verzeichnis an, in dem die Ausgabedateien abgelegt werden. Die Standardeinstellung ist die
aktuelles Arbeitsverzeichnis.

Diese Option wird ignoriert, wenn die Ausgabe auf die Standardausgabe geschrieben werden soll (getriggert
nach der Option --to-stdout).

--to-stdout
Schreiben Sie die Ausgabe in die Standardausgabe statt in einzelne Dateien.

Wenn diese Option verwendet wird, auch wenn mehrere Ausgaben vorgesehen sind
Dokumente, dann wird alles zur Standardausgabe verkettet. Aber pass auf das auf
die meisten anderen Programme akzeptieren diese verkettete Ausgabe nicht.

Diese Option ist nicht kompatibel mit --list-Dateien, Offensichtlich.

--help Kurze Nutzungsinformationen anzeigen und beenden.

--Version
Version anzeigen und beenden.

Auf einige Manpages kann unter zwei oder mehr Namen verwiesen werden, statt nur unter einem. Für
Beispiel strcpy(3) und streng(3) verweisen oft auf dieselbe Manpage, die die beiden beschreibt
Funktionen zusammen. Wählen Sie eine der folgenden Optionen, um auszuwählen, wie solche Manpages aussehen
generiert werden:

- Symlinks
Erstellen Sie für jeden alternativen Namen einer Manpage symbolische Links zu
Datei, die den eigentlichen Inhalt der Manpage enthält.

--solinks
Generieren Sie Stub-Seiten (mithilfe von .so-roff-Anfragen) für die alternativen Namen und zeigen Sie darauf
sie zum eigentlichen Inhalt der Manpage hinzu.

--keine Links
Stellen Sie keine alternativen Namen zur Verfügung. Auf die Manpage kann nur verwiesen werden
unter seinem Hauptnamen.

Dieses Programm verwendet bestimmte andere Programme für seinen Betrieb. Wenn sie nicht in ihrer
standardmäßig installierte Speicherorte, und verwenden Sie dann die folgenden Optionen, um ihren Speicherort festzulegen:

--utf8trans-Programm=Weg, --utf8trans-map=Charmap
Verwenden Sie die Zeichentabelle Charmap an. Nach der Installation können Sie HEIC-Dateien mit der utf8trans(1) Programm, im Lieferumfang enthalten
docbook2X, gefunden unter Weg.

--iconv-programm=Weg
Der Standort der iconv(1) Programm, das zum Kodieren von Konvertierungen verwendet wird.

ANMERKUNG

Die erstellten Manpages sollten mit den meisten troff-Implementierungen und anderen kompatibel sein
Tools, die Manpages verarbeiten. Einige abwärtskompatibel groff(1) Erweiterungen werden verwendet
Lassen Sie die Ausgabe schöner aussehen.

Verwenden Sie db2x_manxml online über die Dienste von onworks.net