db2x_xsltproc – Online in der Cloud

PROGRAMM:

NAME/FUNKTION

db2x_xsltproc – XSLT-Prozessor-Aufruf-Wrapper

ZUSAMMENFASSUNG

db2x_xsltproc [Optionen] xml-Dokument

BESCHREIBUNG

db2x_xsltproc ruft den XSLT 1.0-Prozessor für docbook2X auf.

Dieser Befehl wendet das XSLT-Stylesheet an (normalerweise bereitgestellt von - Stylesheet Option) zum
XML-Dokument in der Datei xml-Dokument. Das Ergebnis wird in die Standardausgabe geschrieben (es sei denn
geändert mit --Ausgabe).

Um das XML-Quelldokument aus der Standardeingabe zu lesen, geben Sie - als Eingabedokument an.

OPTIONAL

--Version
Zeigen Sie die docbook2X-Version an.

TRANSFORMATION AUSGABE OPTIONAL
--Ausgabe Datei, -o Datei
Schreibt die Ausgabe in die angegebene Datei (oder URI) statt in die Standardausgabe.

SOURCE DOKUMENT OPTIONAL
--xinclude, -I
Verarbeiten Sie XInclude-Anweisungen im Quelldokument.

--sgml, -S
Geben Sie an, dass das Eingabedokument SGML statt XML ist. Du brauchst dieses Set
Option, wenn xml-Dokument ist eigentlich eine SGML-Datei.

Das SGML-Parsing wird durch Konvertierung in XML über implementiert sgml2xml(1) aus der SP
Paket (bzw osx(1) aus dem OpenSP-Paket). Alle Tag-Namen in der SGML-Datei sind
auf Kleinbuchstaben normalisiert (d. h. die -xlower Option sgml2xml(1) verwendet wird). AUSWEIS
Für das Stylesheet stehen Attribute zur Verfügung (z. B. Option -xid). Darüber hinaus jede
Im SGML-Dokument verwendete ISO-SDATA-Entitäten werden automatisch in ihre umgewandelt
XML-Unicode-Äquivalente. (Dies geschieht durch a Durst Filter.)

Die Kodierung des SGML-Dokuments muss mit angegeben werden, wenn es nicht us-ascii ist
die Standard-SP-Umgebungsvariablen: SP_CHARSET_FIXED=1 SP_ENCODING=Codierung.
(Beachten Sie, dass XML-Dateien ihre Kodierung mit der XML-Deklaration angeben <?xml
version="1.0" Kodierung="Codierung" ?> oben in der Datei.)

Die oben genannten Konvertierungsoptionen können nicht geändert werden. Wenn Sie eine andere Konvertierung wünschen
Optionen, die Sie aufrufen sollten sgml2xml(1) manuell und geben Sie dann die Ergebnisse weiter
Umstellung auf dieses Programm.

ABRUF OPTIONAL
--Kataloge Katalogdateien, -C Katalogdateien
Geben Sie zusätzliche XML-Kataloge an, die zum Auflösen formaler öffentlicher Bezeichner oder verwendet werden sollen
URIs. SGML-Kataloge werden nicht unterstützt.

Diese Kataloge sind nicht Wird zum Parsen eines SGML-Dokuments unter verwendet --sgml .
Verwenden Sie die Umgebungsvariable SGML_CATALOG_FILES Stattdessen sollen die Kataloge für angegeben werden
Parsen des SGML-Dokuments.

--Netzwerk, -N
db2x_xsltproc weigert sich normalerweise, externe Ressourcen aus dem Netzwerk zu laden, z
sicherheits Gründe. Wenn Sie aus dem Netzwerk laden möchten, aktivieren Sie diese Option.

Normalerweise möchten Sie die relevanten DTDs und andere Dateien lokal installiert haben
Richten Sie Kataloge für sie ein, anstatt sie automatisch aus dem Netzwerk zu laden.

STILBLATT OPTIONAL
- Stylesheet Datei, -s Datei
Geben Sie den Dateinamen (oder URI) des zu verwendenden Stylesheets an. Die besonderen Werte Mensch und
Texi werden als Abkürzungen akzeptiert, um das zu spezifizieren xml-Dokument ist in DocBook und
sollte in Manpages bzw. Texinfo konvertiert werden.

--param Name=ausdr, -p Name=ausdr
Fügen Sie dem Stylesheet einen Parameter hinzu oder ändern Sie ihn. Name ist ein XSLT-Parametername und
ausdr ist ein XPath-Ausdruck, der den gewünschten Wert für den Parameter ergibt.
(Das bedeutet, dass Zeichenfolgen in Anführungszeichen gesetzt werden müssen, in Zusatz zum üblichen Zitieren von Shell
Argumente; verwenden --string-param um es zu umgehen.)

--string-param Name=Schnur, -g Name=Schnur
Fügen Sie dem Stylesheet einen String-Wert-Parameter hinzu oder ändern Sie ihn.

Die Zeichenfolge muss in UTF-8 kodiert sein (unabhängig von der Zeichenkodierung des Gebietsschemas).

FEHLERBEHEBUNG UND PROFILIERUNG
--debuggen, -d
Zeigen Sie im Standardfehlerprotokoll Protokolle darüber an, was während der XSL geschieht
Transformation.

--nesting-limit n, -D n
Ändern Sie die maximale Anzahl verschachtelter Aufrufe an XSL-Vorlagen, die zur Erkennung verwendet werden
potenzielle Endlosschleifen. Wenn nicht angegeben, beträgt der Grenzwert 500 (Standardeinstellung von libxslt).

--Profil, -P
Profilinformationen anzeigen: Die Gesamtzahl der Aufrufe jeder Vorlage im
Stylesheet und die dafür benötigte Zeit. Diese Informationen werden standardmäßig ausgegeben
Fehler.

--xslt-processor Prozessor, -X Prozessor
Wählen Sie den zugrunde liegenden XSLT-Prozessor aus. Die möglichen Auswahlmöglichkeiten für Prozessor sind:
libxslt, saxon, xalan-j.

Der Standardprozessor ist der, der bei der Erstellung von docbook2X festgelegt wurde. libxslt ist
empfohlen (weil es schlank und schnell ist), aber SAXON ist viel robuster und würde es tun
beim Debuggen von Stylesheets hilfreicher sein.

Bei allen Prozessoren ist die Unterstützung für XML-Kataloge aktiviert. (docbook2X erfordert es.)
Beachten Sie jedoch, dass nicht alle oben genannten Optionen mit anderen Prozessoren als libxslt funktionieren
eins.

XML_CATALOG_FILES
Geben Sie XML-Kataloge an. Wenn nicht angegeben, wird der Standardkatalog (/etc/xml/catalog) abgestimmt ist, lautet
geladen, sofern verfügbar.

DB2X_XSLT_PROCESSOR
Geben Sie den zu verwendenden XSLT-Prozessor an. Der Effekt ist der gleiche wie der --xslt-processor
Möglichkeit. Der Hauptzweck dieser Variablen besteht darin, Ihnen das schnelle Testen verschiedener Variablen zu ermöglichen
XSLT-Prozessoren, ohne sie hinzufügen zu müssen --xslt-processor zu jedem Skript oder jeder Make-Datei
in Ihrem Dokumentations-Build-System.

KONFORM TO

XML Stylesheet Language – Transformationen (XSLT), Version 1.0 ⟨http://www.w3.org/TR/xslt⟩
, eine W3C-Empfehlung.

ANMERKUNG

In seinen früheren Versionen (< 0.8.4) benötigte docbook2X zur Ausführung XSLT-Erweiterungen und
db2x_xsltproc war ein spezieller libxslt-basierter Prozessor, in den diese Erweiterungen einkompiliert waren.
Als die Anforderung für XSLT-Erweiterungen gestrichen wurde, db2x_xsltproc wurde ein Perl-Skript
was die Optionen übersetzt in db2x_xsltproc um dem vom akzeptierten Format zu entsprechen
-bestands- xsltproc(1), das mit libxslt geliefert wird.

Der Hauptgrund für die Existenz dieses Skripts ist die Abwärtskompatibilität mit allen
Skripte erstellen oder Dateien erstellen, die docbook2X aufrufen. Es wurde jedoch auch einfacher, es hinzuzufügen
Unterstützung für den Aufruf anderer XSLT-Prozessoren mit einer einheitlichen Befehlszeilenschnittstelle. In der Tat,
Dieses Skript enthält nichts Besonderes für docbook2X oder sogar für DocBook, und das ist möglicherweise der Fall
Wird bei Bedarf zum Ausführen anderer Arten von Stylesheets verwendet. Sicherlich bevorzugt der Autor
Verwenden Sie diesen Befehl, da sein Aufrufformat sinnvoll und einfach zu verwenden ist. (z. B. Nr
Eingabe langer Klassennamen für die Java-basierten Prozessoren!)

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