.de Sh " Subsection .if t .Sp .ne 5

$1

.. .de Sp " Vertical space (when we can't use .PP) .if t .5v .if n .. .de Ip " List item .ie
(.$>=3 .ne $3 .el .ne 3
[/col][/row][/table]

Nom

xsltproc - processeur xslt en ligne de commande

Résumé

.nf xsltproc [-V | -v | -o fichier | --timing | --repeat | --debug | --novalid | --noout | --maxdepth val | --html | --docbook | --param nom valeur | --stringparam nom valeur | --nonet | --catalogs | --xinclude | --profile | --dumpextensions] [feuille de style] [fichier1] [fichier2] [....] .fi

Introduction


xsltproc est un outil en ligne de commande pour appliquer des feuilles de styles XSLT à des documents XML. C'est une partie de libxslt, la bibliothèque XSLT écrite en C pour GNOME. Bien qu'il ait été développé au sein du projet GNOME, il peut opérer indépendamment du bureau GNOME.

xsltproc est invoqué à partir de la ligne de commande avec le nom de la feuille de style à utiliser suivi du nom du fichier ou des fichiers auxquels la feuille de style doit être appliquée.

Si une feuille de style est incluse dans un document XML avec une instruction de traitement de la feuille de style, il n'est pas nécessaire de spécifier la feuille de style sur la ligne de commande. xsltproc détectera automatiquement la feuille de style qui est incluse et l'utilisera.

Par défaut, la sortie est la sortie standard. Vous pouvez préciser un fichier en tant que sortie en utilisant l'option -o.

Options

-V ou --version Affiche les versions de libxml et libxslt qui sont utilisées.

-v ou --verbose Affiche chaque étape de xsltproc lors du traitement du la feuille de style et du document.

-o ou --output fichier Redirige directement la sortie vers le fichier nommé fichier. Pour des sorties multiples, ce que l'on appelle également le « chunking », -o répertoire/ redirige les fichiers de sortie vers un répertoire donné. Le répertoire doit déjà exister.

--timing Affiche le temps qu'il a fallu pour traiter la feuille de style, traiter le document et appliquer la feuille de style et enregistrer le résultat. Il est affiché en millisecondes.

--repeat Lance la transformation 20 fois de suite. Utile pour des tests de vitesse.

--debug Affiche un arbre XML du document transformé afin de déboguer.

--novalid Évite le chargement de la DTD du document.

--noout N'affiche pas le résultat.

--maxdepth valeur Ajuste la profondeur maximale de la pile avant que libxslt ne conclue qu'il y ait une boucle infinie. La valeur par défaut est 500.

--html Le document en entrée est un fichier HTML.

--docbook Le document en entrée est au format DocBook SGML.

--param nom valeur Passe un paramètre du nom nom et la valeur valeur à la feuille de style. Vous pouvez passer plusieurs paires nom/valeur, jusqu'à 32 valeurs. Si la valeur qui est spécifiée est une chaîne de caractères au lieu du nom d'identification d'un noeud, vous devez utiliser --stringparam à la place.

--stringparam nom valeur Passe un paramètre du nom nom et la valeur value où valeur est une chaîne de caractères au lieu qu'il s'agisse du nom d'identification d'un noeud. (Note : La chaîne doit être en utf-8.)

--nonet Ne pas utiliser Internet pour récupérer les DTD ou les entités.

--catalogs Utilise les catalogues SGML pour résoudre l'emplacement des entités externes. Cela accélère la résolution de la DTD. En ayant un fichier catalogue qui fait référence à la DTD, xsltproc n'aura pas besoin d'utiliser Internet pour récupérer les DTD. xsltproc utilise le catalogue identifié par la variable d'environnement SGML_CATALOG_FILES. Par défaut xsltproc utilise les catalogues XML installés dans /etc/xml/catalog.

--xinclude Traite le document en entrée en utilisant les spécifications Xinclude. Vous pouvez obtenir plus de détails dans les spécification de Xinclude : http://www.w3.org/TR/xinclude/

--profile or --norman Donne des informations détaillant le temps passé pour chaque partie de la feuille de style. C'est utile pour optimiser les performances de la feuille de style.

--dumpextensions Affiche la liste de toutes les extensions enregistrées sur la sortie standard.

Valeurs de retour


xsltproc renvoie des codes fournissant des informations qui peuvent être utilisées lorsque l'on l'utilise dans des scripts.

0 : normal

1 : pas d'argument

2 : trop de paramètres

3 : option inconnue

4 : le traitement de la feuille de style a échoué

5 : erreur dans la feuille de style

6 : erreur dans un des documents

7 : xsl non-supporté :méthode de sortie

8 : la chaîne de paramètre contient à la fois des guillemets simples et doubles

9 : erreur interne de traitement

10 : le traitement a été stoppé par un message d'achèvement

Plus dinformations


la page web de libxml : http://www.xmlsoft.org/

la page web XSLT du W3C : http://www.w3.org/TR/xslt

Auteur

John Fleck.

Traduction

Pierre Machard < pmachard@tuxfamily.org >, 2003