Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	.de Sh " Subsection [b][/b] .if t .Sp .ne 5 [b][/b]$1 .. .de Sp " Vertical space (when we can't use .PP) .if t .5v .if n .. .de Ip " List item [b][/b] .ie (.$>=3 .ne $3 .el .ne 3 [/col][/row][/table] [size=18] [b]Nom[/b] [/size] xmlto - applique une feuille de style XSL à un document XML [size=18] [b]Résumé[/b] [/size] .ad l .hy 0 .HP 6 [b]xmlto[/b] [[b][/b]-o [i]répertoire_sortie[/i]] [[b][/b]-x [i]xsl_personnalisée[/i]] [[b][/b]-m [i]fragment_xsl[/i]] [[b][/b]-v] [[b][/b]-p [i]options_postprocesseur[/i]] [[b][/b]--extensions] [[b][/b]--searchpath [i]chemin[/i]] [[b][/b]--skip-validation] {[i]format[/i]} {[i]fichier[/i]} .ad .hy .ad l .hy 0 .HP 6 [b]xmlto[/b] {[b][/b]--help \| [b][/b]--version} .ad .hy [size=18] [b]Description[/b] [/size] Le but de [b]xmlto[/b] est de convertir un [i]fichier[/i] XML dans un [i]format[/i] souhaité en utilisant tout ce qui semble nécessaire&. Cela peut impliquer deux étapes : [table][row][col]    [/col][col]1. L'application d'une feuille de style XSL appropriée en utilisant un processeur XSL-T&.[/col][/row][/table] [table][row][col]    [/col][col]2. Plus de traitement avec d'autres outils&. Cette étape peut ne pas être nécessaire&.[/col][/row][/table]     Afin de décider quelle feuille de style utiliser et ce qu'il faut faire, s'il n'y en a pas, pour post-traiter la sortie, [b]xmlto[/b] peut utiliser des scripts de format, qui sont de simples scripts shell que [b]xmlto[/b] appelle pendant la conversion&. Le script de format est sélectionné en se basant sur le type du fichier XML et sur le format de sortie souhaité&. [b]xmlto[/b] est fourni avec plusieurs scripts de format pour convertir des fichiers XML DocBook en plusieurs formats&. Vous pouvez spécifier votre propre script de format en utilisant un nom de fichier absolu comme [i]format[/i] sur la ligne de commande&. Premièrement, si on n'a pas explicitement indiqué à [b]xmlto[/b] quelle feuille de style utiliser (avec l'option [b][/b]-x), le script de format sera appelé avec [b]$1[/b] positionné à stylesheet&. La variable d'environnement [b]XSLT_PROCESSOR[/b] contient le nom de base de l'exécutable qui sera utilisé pour réaliser la transformation XSL-T (par exemple xsltproc), et la variable d'environnement [b]XSL_DIR[/b] contient le chemin vers le répertoire contenant quelques feuilles de style bien pratique fournies avec [b]xmlto[/b]&. Le script de format devrait écrire le nom de la feuille de style à utiliser sur la sortie standard et quitter avec succès, ou quitter avec un code de retour non nul s'il n'y a pas de feuille de style appropriée (par exemple, si la seule feuille de style disponible est connue pour ne pas fonctionner avec le processeur XSL-T qui devrait l'utiliser)&. Si rien n'est produit sur la sortie standard et si le script s'achève avec succés, aucune transformation XSL-T ne sera effectuée&. Deuxièmement, après qu'un processeur XSL-T ait été lancé avec la feuille de style, le script de format sera à nouveau appelé, cette fois-ci avec [b]$1[/b] positionné à post-process&. Le script de format devrait effectuer toutes les étapes nécessaires pour traduire la sortie traitée par le processeur XSL-T dans le format de sortie désiré, incluant la copie de la sortie dans le répertoire de sortie souhaité&. Pour le post-traitement, le script de format est lancé dans un répertoire temporaire contenant seulement la sortie traitée (dont le nom est stocké dans [b]XSLT_PROCESSED[/b] et dont le nom de base est celui du fichier XML original avec l'extension remplacée par &.proc)&. La variable [b]INPUT_FILE[/b] est positionnée avec le nom du fichier XML original, [b]OUTPUT_DIR[/b] est positionnée avec le nom du répertoire où la sortie (et seulement la sortie) sera envoyée, et [b]SEARCHPATH[/b] est positionnée avec une liste de répertoires de rechange, separés par le caractère « : », dans lesquels scruter pour des entrées (des images par exemple)&. Si cette étape échoue, le script de format quittera avec un code de retour non nul&. [table][row][col]    [/col][col][b][/b]-v Mode verbeux ([b][/b]-vv pour très verbeux)&. [/col][/row][/table] [table][row][col]    [/col][col][b][/b]-x [i]feuille_de_style[/i] Utiliser [i]feuille_de_style[/i] plutôt que de demander au script de format d'en choisir une&. [/col][/row][/table] [table][row][col]    [/col][col][b][/b]-m [i]fragment[/i] Utiliser le [i]fragment[/i] XSL fourni pour modifier la feuille de style&. [/col][/row][/table] [table][row][col]    [/col][col][b][/b]-o [i]répertoire[/i] Mettre la sortie dans le [i]répertoire[/i] spécifié plutôt que dans le répertoire de travail courant&. [/col][/row][/table] [table][row][col]    [/col][col][b][/b]-p [i]options_postprocesseur[/i] Passe les [i]options_postprocesseur[/i] pour traiter les étapes après l'application de la feuille de style (p&. ex&. lynx ou links quand on transforme du HTML en texte, ou xmltex quand on transforme un fichier TeX en DVI)&. Si on spécifie l'option [b][/b]-p une seconde fois, les options spécifiées seront passées à une deuxième étape de post-traitement ; actuellement, ce n'est applicable qu'à travers xmltex et dvips pour sortir en PostScript&. [/col][/row][/table] [table][row][col]    [/col][col][b][/b]--extensions Active les extensions de feuille de style pour la chaîne d'outils en cours d'utilisation (par exemple, on peut activer [i]passivetex[/i]&.extensions et [i]use[/i]&.extensions si on utilise PassiveTeX)&. Les variables activées sont celles utilisées dans les feuilles de style XSL DocBook de Norman Walsh&. [/col][/row][/table] [table][row][col]    [/col][col][b][/b]--searchpath [i]chemin[/i] Ajouter la liste des répertoires, séparés par le symbole « : », de [i]chemin[/i] comme répertoires de rechange pour inclure l'entrée&. [/col][/row][/table] [table][row][col]    [/col][col][b][/b]--skip-validation Sauter l'étape de validation qui est normalement effectuée&. [/col][/row][/table] [table][row][col]    [/col][col][b][/b]--help Affiche un court message d'utilisation&. Il décrit les options de xmlto ainsi que les formats de sortie disponibles&. [/col][/row][/table] [table][row][col]    [/col][col][b][/b]--version Affiche le numéro de version de xmlto&. [/col][/row][/table] [size=18] [b]Exemples[/b] [/size] Pour convertir un document XML DocBook en PDF, utilisez : [table][row][col]    [/col][col].nf xmlto pdf mydoc&.xml .fi [/col][/row][/table] Pour convertir un document XML DocBook en HTML et stocker les fichiers HTML résultants dans un répertoire à part, utilisez : [table][row][col]    [/col][col].nf xmlto -o html-dir html mydoc&.xml .fi [/col][/row][/table] Pour convertir un document XML DocBook en un fichier HTML unique, utilisez : [table][row][col]    [/col][col].nf xmlto html-nochunks mydoc&.xml .fi [/col][/row][/table] Pour modifier la sortie en utilisant un fragment XSL, utilisez : [table][row][col]    [/col][col].nf xmlto -m ulink&.xsl pdf mydoc&.xml .fi [/col][/row][/table] Pour spécifier quelle feuille de style utiliser (annulant celle que le script de format aurait choisie), utilisez : [table][row][col]    [/col][col].nf xmlto -x mystylesheet&.xsl pdf mydoc&.xml .fi [/col][/row][/table] [size=18] [b]Auteur[/b] [/size] Tim Waugh <twaugh@redhat&.com>. [size=18] [b]Traduction[/b] [/size] Alain Portal <aportal AT univ-montp2 DOT fr>, 10 mai 2004 [size=18] [b]Traduction[/b] [/size] Il est possible que cette traduction soit imparfaite ou périmée. En cas de doute, veuillez vous reporter au document original en langue anglaise fourni avec le programme.
Fichier