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, xmlto peut utiliser des scripts de format, qui sont de simples scripts shell que xmlto 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é. xmlto 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 format sur la ligne de commande.
Premièrement, si on n'a pas explicitement indiqué à xmlto quelle feuille de style utiliser (avec l'option -x), le script de format sera appelé avec $1 positionné à stylesheet. La variable d'environnement XSLT_PROCESSOR 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 XSL_DIR contient le chemin vers le répertoire contenant quelques feuilles de style bien pratique fournies avec xmlto. 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 $1 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 XSLT_PROCESSED et dont le nom de base est celui du fichier XML original avec l'extension remplacée par .proc). La variable INPUT_FILE est positionnée avec le nom du fichier XML original, OUTPUT_DIR est positionnée avec le nom du répertoire où la sortie (et seulement la sortie) sera envoyée, et SEARCHPATH 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.
Pour convertir un document XML DocBook en PDF, utilisez :
xmlto pdf mydoc.xml
Pour convertir un document XML DocBook en HTML et stocker les fichiers HTML résultants dans un répertoire à part, utilisez :
xmlto -o html-dir html mydoc.xml
Pour convertir un document XML DocBook en un fichier HTML unique, utilisez :
xmlto html-nochunks mydoc.xml
Pour modifier la sortie en utilisant un fragment XSL, utilisez :
xmlto -m ulink.xsl pdf mydoc.xml
Pour spécifier quelle feuille de style utiliser (annulant celle que le script de format aurait choisie), utilisez :
xmlto -x mystylesheet.xsl pdf mydoc.xml
Alain Portal <aportal AT univ-montp2 DOT fr>, 10 mai 2004
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.