db2x_xsltproc - Online in de cloud

PROGRAMMA:

NAAM

db2x_xsltproc - Aanroepwrapper voor XSLT-processor

KORTE INHOUD

db2x_xsltproc [opties] xml-document

PRODUCTBESCHRIJVING

db2x_xsltproc roept de XSLT 1.0-processor aan voor docbook2X.

Met deze opdracht wordt het XSLT-stylesheet toegepast (meestal gegeven door de --stijlblad optie) naar de
XML-document in het bestand xml-document. Het resultaat wordt naar standaarduitvoer geschreven (tenzij
veranderd met --uitvoer).

Om het XML-brondocument uit standaardinvoer te lezen, geeft u - op als invoerdocument.

OPTIES

--versie
Geef de docbook2X-versie weer.

TRANSFORMATIE OUTPUT OPTIES
--uitvoer filet, -o filet
Schrijf uitvoer naar het opgegeven bestand (of URI), in plaats van standaarduitvoer.

BRON DOCUMENT OPTIES
--xinsluiten, -I
Proces XNeem richtlijnen op in het brondocument.

--sgml, -S
Geef aan dat het invoerdocument SGML is in plaats van XML. Je hebt deze set nodig
optie als xml-document is eigenlijk een SGML-bestand.

SGML-parsing wordt geïmplementeerd door conversie naar XML via sgml2xml(1) van de SP
pakket (of osx(1) uit het OpenSP-pakket). Alle tagnamen in het SGML-bestand zijn
genormaliseerd naar kleine letters (dat wil zeggen de -xlager optie van sgml2xml(1) wordt gebruikt). ID kaart
attributen zijn beschikbaar voor het stylesheet (dwz optie -xid). Bovendien, eventuele
ISO SDATA-entiteiten die in het SGML-document worden gebruikt, worden automatisch geconverteerd naar hun
XML Unicode-equivalenten. (Dit wordt gedaan door A dorst filter.)

De codering van het SGML-document, als deze niet us-ascii is, moet worden opgegeven met
de standaard SP-omgevingsvariabelen: SP_CHARSET_FIXED=1 SP_ENCODING=codering.
(Merk op dat XML-bestanden hun codering specificeren met de XML-declaratie <?xml
versie = "1.0" codering = "codering" ?> bovenaan het bestand.)

De bovenstaande conversieopties kunnen niet worden gewijzigd. Als u een andere conversie wenst
opties die u moet aanroepen sgml2xml(1) handmatig, en geef vervolgens de resultaten daarvan door
conversie naar dit programma.

OPHALEN OPTIES
--catalogi catalogus-bestanden, -C catalogus-bestanden
Geef aanvullende XML-catalogi op die u wilt gebruiken voor het oplossen van formele openbare identificatiegegevens of
URI's. SGML-catalogi worden niet ondersteund.

Deze catalogi zijn niet gebruikt voor het parseren van een SGML-document onder de --sgml optie.
Gebruik de omgevingsvariabele SGML_CATALOG_FILES in plaats daarvan om de catalogi voor op te geven
het parseren van het SGML-document.

--netwerk, -N
db2x_xsltproc normaal gesproken weigeren externe bronnen van het netwerk te laden
veiligheidsredenen. Als u wel vanaf het netwerk wilt laden, stelt u deze optie in.

Meestal wilt u de relevante DTD's en andere bestanden lokaal geïnstalleerd hebben, en
catalogi voor hen opzetten, in plaats van ze automatisch vanaf het netwerk te laden.

STIJLBLAD OPTIES
--stijlblad filet, -s filet
Geef de bestandsnaam (of URI) op van het stijlblad dat u wilt gebruiken. De bijzondere waarden mens en
texi worden geaccepteerd als afkortingen om dat te specificeren xml-document staat in DocBook en
moeten worden geconverteerd naar respectievelijk manpagina's of Texinfo.

--param naam=uitdrukken, -p naam=uitdrukken
Voeg een parameter toe aan het stylesheet of wijzig deze. naam is een XSLT-parameternaam, en
uitdrukken is een XPath-expressie die de gewenste waarde voor de parameter oplevert.
(Dit betekent dat strings tussen aanhalingstekens moeten staan, in toevoeging naar het gebruikelijke citaat van shell
argumenten; gebruik --string-parameter om dit te voorkomen.)

--string-parameter naam=snaar, -g naam=snaar
Voeg een parameter met een tekenreekswaarde toe aan het stylesheet of wijzig deze.

De tekenreeks moet worden gecodeerd in UTF-8 (ongeacht de tekencodering van de landinstelling).

DEBUGEN EN PROFILERING
--debuggen, -d
Weergave, tot standaardfout, logs van wat er gebeurt tijdens de XSL
transformatie.

--nesting-limiet n, -D n
Wijzig het maximale aantal geneste aanroepen naar XSL-sjablonen die worden gebruikt om te detecteren
potentiële oneindige lussen. Indien niet gespecificeerd, is de limiet 500 (de standaardinstelling van libxslt).

--profiel, -P
Profielinformatie weergeven: het totale aantal oproepen naar elke sjabloon in de
stylesheet en de tijd die voor elk ervan nodig is. Deze informatie wordt standaard uitgevoerd
fout.

--xslt-processor processor, -X processor
Selecteer de onderliggende XSLT-processor die wordt gebruikt. De mogelijke keuzes voor processor zijn:
libxslt, saksisch, xalan-j.

De standaardprocessor is de processor die was ingesteld toen docbook2X werd gebouwd. libxslt is
aanbevolen (omdat het slank en snel is), maar SAXON is veel robuuster en zou dat ook doen
nuttiger zijn bij het debuggen van stylesheets.

Voor alle processors is ondersteuning voor XML-catalogi ingeschakeld. (docbook2X vereist dit.)
Maar houd er rekening mee dat niet alle bovenstaande opties werken met andere processors dan de libxslt
een.

MILIEU

XML_CATALOG_FILES
Geef XML-catalogi op. Indien niet gespecificeerd, wordt de standaardcatalogus (/etc/xml/catalog) is
geladen, indien beschikbaar.

DB2X_XSLT_PROCESSOR
Geef op welke XSLT-processor u wilt gebruiken. Het effect is hetzelfde als de --xslt-processor
keuze. Het primaire gebruik van deze variabele is om u in staat te stellen snel verschillende te testen
XSLT-processors zonder dat u ze hoeft toe te voegen --xslt-processor voor elk script of make-bestand
in uw documentatiebouwsysteem.

CONFORM TO

XML Stylesheet Taal – Transformaties (XSLT), versie 1.0 ⟨http://www.w3.org/TR/xslt⟩
, een W3C-aanbeveling.

OPMERKINGEN

In eerdere versies (< 0.8.4) had docbook2X XSLT-extensies nodig om te kunnen werken, en
db2x_xsltproc was een speciale op libxslt gebaseerde processor waarin deze extensies waren gecompileerd.
Toen de vereiste voor XSLT-extensies werd geschrapt, db2x_xsltproc werd een Perl-script
waar de opties naar worden vertaald db2x_xsltproc om te voldoen aan het formaat dat is geaccepteerd door de
voorraad xsltproc(1) die wordt geleverd met libxslt.

De belangrijkste reden voor het bestaan ​​van dit script is achterwaartse compatibiliteit met elk script
scripts of maak bestanden die docbook2X aanroepen. Het werd echter ook gemakkelijk om toe te voegen
ondersteuning voor het aanroepen van andere XSLT-processors met een uniforme opdrachtregelinterface. Inderdaad,
er is niets speciaals in dit script voor docbook2X, of zelfs voor DocBook, en dat kan ook zo zijn
gebruikt voor het uitvoeren van andere soorten stylesheets als u dat wenst. De auteur heeft daar uiteraard de voorkeur aan
met behulp van deze opdracht, omdat het aanroepformaat gezond is en gemakkelijk te gebruiken. (bijv. nee
lange klassenamen typen voor de op Java gebaseerde processors!)

Gebruik db2x_xsltproc online met behulp van onworks.net-services