db2x_xsltproc - En ligne dans le cloud

PROGRAMME:

Nom

db2x_xsltproc - Wrapper d'invocation du processeur XSLT

SYNOPSIS

db2x_xsltproc [Options] document-xml

DESCRIPTION

db2x_xsltproc appelle le processeur XSLT 1.0 pour docbook2X.

Cette commande applique la feuille de style XSLT (généralement donnée par le --feuille de style option) à la
Document XML dans le fichier document-xml. Le résultat est écrit sur la sortie standard (sauf si
changé avec --output).

Pour lire le document XML source à partir de l'entrée standard, spécifiez - comme document d'entrée.

OPTIONS

--version
Affichez la version de docbook2X.

TRANSFORMATION SORTIE OPTIONS
--output filet, -o filet
Écrire la sortie dans le fichier (ou l'URI) donné, au lieu de la sortie standard.

SOURCE DOCUMENT OPTIONS
--xinclude, -I
Traiter les directives XInclude dans le document source.

--sgml, -S
Indiquez que le document d'entrée est SGML au lieu de XML. Vous avez besoin de cet ensemble
option si document-xml est en fait un fichier SGML.

L'analyse SGML est implémentée par conversion en XML via sgml2xml(1) du SP
paquet (ou osx(1) du package OpenSP). Tous les noms de balises dans le fichier SGML seront
normalisé en minuscule (c'est-à-dire le -xinférieur option de sgml2xml(1) est utilisé). identifiant
les attributs sont disponibles pour la feuille de style (c'est-à-dire l'option -xid). De plus, tout
Les entités ISO SDATA utilisées dans le document SGML sont automatiquement converties dans leur
Équivalents XML Unicode. (Ceci est fait par un sed filtre.)

L'encodage du document SGML, s'il n'est pas us-ascii, doit être spécifié avec
les variables d'environnement SP standard : SP_CHARSET_FIXED=1 SP_ENCODAGE=codage.
(Notez que les fichiers XML précisent leur encodage avec la déclaration XML <?xml
version="1.0" encodage="codage" ?> en haut du fichier.)

Les options de conversion ci-dessus ne peuvent pas être modifiées. Si vous désirez une conversion différente
options, vous devez appeler sgml2xml(1) manuellement, puis transmettez les résultats de cette
conversion à ce programme.

RÉCUPÉRATION OPTIONS
--catalogues fichiers-catalogue, -C fichiers-catalogue
Spécifiez des catalogues XML supplémentaires à utiliser pour résoudre les identificateurs publics formels ou
URI. Les catalogues SGML ne sont pas pris en charge.

Ces catalogues sont ne sauraient utilisé pour analyser un document SGML sous le --sgml option.
Utiliser la variable d'environnement SGML_CATALOG_FILES à la place de spécifier les catalogues pour
l'analyse du document SGML.

--réseau, -N
db2x_xsltproc refusera normalement de charger des ressources externes à partir du réseau, par
raisons de sécurité. Si vous souhaitez charger à partir du réseau, définissez cette option.

Habituellement, vous voulez avoir installé localement les DTD et autres fichiers pertinents, et
mettre en place des catalogues pour eux, plutôt que de les charger automatiquement à partir du réseau.

FICHE DE STYLE OPTIONS
--feuille de style filet, -s filet
Spécifiez le nom de fichier (ou URI) de la feuille de style à utiliser. L'homme aux valeurs spéciales et
texi sont acceptés comme abréviations, pour préciser que document-xml est dans DocBook et
doivent être convertis en pages de manuel ou en Texinfo (respectivement).

--param prénom=expr, -p prénom=expr
Ajoutez ou modifiez un paramètre à la feuille de style. prénom est un nom de paramètre XSLT, et
expr est une expression XPath qui évalue la valeur souhaitée pour le paramètre.
(Cela signifie que les chaînes doivent être entre guillemets, in ajout à la citation habituelle de shell
arguments; utilisation --chaîne-param pour éviter cela.)

--chaîne-param prénom=un magnifique, -g prénom=un magnifique
Ajoutez ou modifiez un paramètre à valeur de chaîne dans la feuille de style.

La chaîne doit être encodée en UTF-8 (quel que soit l'encodage des caractères des paramètres régionaux).

DÉBOGAGE ET PROFILAGE
--déboguer, -d
Afficher, à l'erreur standard, les journaux de ce qui se passe pendant le XSL
la transformation.

--nidification-limite n, -D n
Modifiez le nombre maximal d'appels imbriqués en modèles XSL, utilisés pour détecter
boucles infinies potentielles. Si non spécifié, la limite est de 500 (valeur par défaut de libxslt).

--profil, -P
Afficher les informations du profil : le nombre total d'appels vers chaque modèle dans le
feuille de style et le temps pris pour chacun. Cette information est sortie en standard
Erreur.

--xslt-processeur processeur, -X processeur
Sélectionnez le processeur XSLT sous-jacent utilisé. Les choix possibles pour processeur sont:
libxslt, saxon, xalan-j.

Le processeur par défaut est celui qui a été défini lors de la création de docbook2X. libxslt est
recommandé (car il est maigre et rapide), mais SAXON est beaucoup plus robuste et
être plus utile lors du débogage des feuilles de style.

Tous les processeurs ont la prise en charge des catalogues XML activée. (docbook2X l'exige.)
Mais notez que toutes les options ci-dessus ne fonctionnent pas avec des processeurs autres que libxslt
une.

ENVIRONNEMENT

XML_CATALOG_FILES
Spécifiez les catalogues XML. Si non spécifié, le catalogue standard (/etc/xml/catalogue) est
chargé, si disponible.

DB2X_XSLT_PROCESSOR
Spécifiez le processeur XSLT à utiliser. L'effet est le même que le --xslt-processeur
option. L'utilisation principale de cette variable est de vous permettre de tester rapidement différents
Processeurs XSLT sans avoir à ajouter --xslt-processeur à chaque script ou fichier make
dans votre système de génération de documentation.

CONFORME À

Langage de feuille de style XML – Transformations (XSLT), version 1.0 ⟨http://www.w3.org/TR/xslt⟩
, une recommandation du W3C.

NOTES

Dans ses versions antérieures (< 0.8.4), docbook2X nécessitait des extensions XSLT pour s'exécuter, et
db2x_xsltproc était un processeur spécial basé sur libxslt qui avait ces extensions compilées.
Lorsque l'exigence des extensions XSLT a été abandonnée, db2x_xsltproc est devenu un script Perl
qui traduit les options en db2x_xsltproc se conformer au format accepté par le
stock xsltproc(1) qui vient avec libxslt.

La principale raison de l'existence de ce script est la rétrocompatibilité avec n'importe quel
scripts ou créer des fichiers qui invoquent docbook2X. Cependant, il est également devenu facile d'ajouter
prise en charge de l'appel d'autres processeurs XSLT avec une interface de ligne de commande unifiée. En effet,
il n'y a rien de spécial dans ce script à docbook2X, ou même à DocBook, et il se peut
utilisé pour exécuter d'autres types de feuilles de style si vous le désirez. Certes, l'auteur préfère
à l'aide de cette commande, car son format d'invocation est sain et facile à utiliser. (par exemple non
taper des noms de classe longs pour les processeurs basés sur Java !)

Utiliser db2x_xsltproc en ligne à l'aide des services onworks.net