| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Sommaire L'essentiel Installation Concepts Format de fichier de Session XTrans |
3. Format de fichier XTrans
If you see this message, it means that your browser does not enable "style sheets".
Please enable the style sheets in your browser options or preferences, otherwise go to the "nostyle" version of Kervarker
here (note that you may have to enable JavaScript too).
3.1 IntroductionLes instructions sont insensibles à la casse, mais les arguments et l'object xtrans le sont.
Toute ligne commençant par # dans le fichier xtrans est considérée comme un commentaire et ignorée.
3.2 Instructions3.2.1 Inclusion de fichier xtrans
On peut inclure en série et il n'y a pas de limite fixée sur le nombre d'inclusions.
3.2.2 Importer un module python
Cette instruction fonctionne exactement comme celle de Python.
Notez que les modules string, os, re, sys, fphash, shutil sont déjà
chargés et qu'il est inutile de les importer de nouveau.
3.2.3 Variables globales
La variable est ensuite accessible par xtrans.variablename dans le reste du fichier.
3.2.4 Définition de fonctions
Tous les attributs et méthodes de l'objet xtrans sont accessibles dans la définition de la fonction.
La fonction est ensuite accessible par xtrans.functionname dans le reste du fichier.
3.2.5 Définition des délimiteurs de post-traitement
Cette instruction est optionnelle. Si elle est omise, les délimiteurs par défaut sont [ ].
3.2.6 Définition de postmacro
La postmacro est insérée dans les fichiers cibles entourée des délimiteurs de post-traitement.
La postmacro est éxécutée dans un environnement différent du reste du fichier xtrans.
D'abord, une variable locale currentfileno contient l'indice du fichier cible dans lequel on interprète la macro.
Ensuite, deux nouveaux attributs xtrans sont définis : xtrans.filenames et xtrans.labels.
Voir la section sur les variables prédéfinies pour plus de détails.
3.2.7 Action balise ouvrante
Tous les attributs et méthodes de l'objet xtrans sont accessibles dans la définition du code.
Si l'argument tagname est suivi par le mot-clé nostrip, tous les espaces entourant les balises intérieures sont conservés.
3.2.8 Action balise fermante
Tous les attributs et méthodes de l'objet xtrans sont accessibles dans la définition du code.
3.3 Variables globales prédéfiniesToutes les variables prédéfinies sont en lecture seule.
3.3.1 Variables d'environnementElle représentent toute l'information disponible concernant le parsing en cours.
3.3.2 Variables XMLLes variables XML contiennent les informations concernant le contenu et les attributs
des balises XML.
3.3.3 Variables globales PostmacroLes variables globales Postmacro ne sont définies que lors de la phase de post-traitement.
3.4 Fonctions prédéfinies3.4.1 Redirection de la sortie principale
Les noms de fichiers et leurs labels associées sont accessibles durant le post-traitement. Voir variables globales Postmacro.
On écrit dans le fichier de sortie en utilisant xtrans.output.write(string) ou le raccourci
xtrans.put qui
sélectionne la sortie.Voir aussi
xtrans.use_tmp_output .3.4.2 Utiliser une sortie temporaire ou auxiliaire
Retourne le nom du fichier auxiliaire, relativement au fichier de sortie principal.
À n'utiliser que pour des sous-pages exploitées immédiatement dans le parsing.
La sortie temporaire court-circuite la sortie principale dans le racourcis
xtrans.put .3.4.3 Fermer une sortie temporaire ou auxiliaire
Ferme la sortie temporaire.
3.4.4 Écrire sur la sortie
C'est un racourci pratique qui écrit sur la sortie temporaire si elle est ouverte, sur la sortie principale sinon.
3.4.5 Tester le contexte
On peut ainsi écrire du code contextuel.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||