Documentation technique XSL/XSD du kit de génération
Explication des fichiers XSL/XSD
Date de publication : 31/03/2012.
Par
djibril
Cette documentation sert à comprendre le rôle de chaque fichier XSL/XSD dans le kit de génération qui nous permet de générer les pages d'articles, FAQ, sources...
I. Introduction
Dans cet article, nous n'expliquerons que les fichiers XSL/XSD se trouvant dans les répertoires /racine/kit/xsl et /racine/kit/xsd.
II. Abus de langage
Je nommerai par fonction, les balises xsl:template ayant l'attribut name. Par exemple, la fonction summary correspond au code :
< xsl : template name = " summary " >
...
< / xsl : template >
|
L'instruction apply-templates signifie : « continuer la transformation pour les enfants de l'élément courant (en cours de transformation) ».
Exemple :
< xsl : template match = " expression XPath " >
instructions et/ou sortie à générer
< xsl : apply-templates / >
instructions et/ou sortie à générer
< / xsl : template >
|
Ou
< xsl : template name = " nom_template " >
instructions et/ou sortie à générer
< xsl : apply-templates / >
instructions et/ou sortie à générer
< / xsl : template >
|
III. Répertoire /racine/KIT/XSL
III-A. Annotations.xsl
Ce fichier contient une fonction notesBasPage pour la construction de la section note de bas de page.
Il contient un patron nommé annotation qui est appelé pour la construction de la section des notes de bas de page.
III-B. Article.xsl
Ce fichier contient plusieurs fonctions :
- lecteur : contiendra les informations du niveau et de la durée de l'article ;
- niveau : texte de la balise ;
- duree :texte de la balise ;
- titreArticle : texte de la balise ;
- dateArticle : contient la date de publication et de modification ;
- authors : met en forme la liste des auteurs de l'article ;
- author : permet de configurer l'affichage d'un auteur :
- Blog ;
- Google+ ;
- liens personnels (logo) ;
- URL du site personnel.
- Synopsis ;
- footer-personnalise-online : footer pour les article en ligne ;
- footer-personnalise-offline : footer pour les articles offline.
Il contient la fonction d'établissement des liens inter-page protos surcharges en cas de besoin :
linkSummary, linkQuestion et linkSection.
III-C. ArticleEditeur.xsl
À voir !
III-D. ArticleOffLine.xslt
Cette feuille est appelé par saxon dans le programme (buildart) de construction des pages d'articles mono-page et fait appel aux fichiers :
- DeveloppezOffLine.xsl ;
- Article.xsl ;
- Tutoriel.xsl ;
- Sommaire.xsl ;
- Texte.xsl ;
- Annotations.xsl ;
- Code.xsl ;
- ArticleOnePage.xslt ;
- ArticleSommaire.xslt.
Il contient le patron principal gérant les articles mono et multipages offline.
Il contient le patron générant le contenu du fichier index.html contenant l'intégralité d'un article monopage.
Il contient le patron générant le fichier sommaire.html d'un article multipages.
Il contient la fonction d'établissement des liens inter-page protos surcharges en cas de besoin :
linkSummary, linkQuestion et linkSection.
III-E. ArticleOnePage.xslt
Ce fichier contient un patron pageArticle pour la mise en page générale d'un article.
Il contient une fonction barreNavigation pour la barre de navigation en haut et bas de page.
Il y a la fonction summaryPage pour mettre en place les liens de navigation entre pages.
Il y a la fonction tutorielPage, notesBasPageMulti toujours pour les articles multi-page.
III-F. ArticleOnLine.xslt
Cette feuille est appelée par saxon dans le programme (buildart) de construction des pages d'articles mono-page et fait appel aux fichiers :
- DeveloppezOnLine.xsl ;
- Article.xsl ;
- Tutoriel.xsl ;
- Sommaire.xsl ;
- Texte.xsl ;
- Annotations.xsl ;
- Code.xsl ;
- ArticleOnePage.xslt ;
- ArticleSommaire.xslt.
Il contient le patron principal gérant les articles mono et multipages online.
Il contient le patron générant le contenu du fichier index.php contenant l'intégralité d'un article monopage.
Il appelle la création du sommaire, des liens de navigation, du corps de l'article...
La fonction d'établissement des liens inter-page protos surcharges en cas de besoin :
linkQuestion et linkSection.
III-G. ArticlePrevisu.xslt
Cet XSL n'est utilisé que par l'éditeur XML pour une prévisualisation rapide : F7.
Il n'est pas utilisé pour la génération.
III-H. ArticleSommaire.xsl
Il fait appel à la feuille ArticleOnePage.xsl.
Il contient les fonctions articleSommaire pour structurer la page : titre, soustitre, dates, auteurs, lecteur, synopsis, sommaire et barre de navigation.
Il permet de gérer aussi le sommaire des articles multi-page.
III-I. ArticleSommaire.xslt
Comme ArticleSommaire.xsl, il permet la mise en page générale de la page pour le sommaire. Il est appelé dans ArticleOnLine.xslt ou ArticleOffLine.xslt.
III-J. Code.xsl
Contient la fonction create-lines pour les numéros de lignes.
III-K. DeveloppezOffLine.xsl
Il contient la variable baseimages contenant le chemin WEB vers les images d'un article (offline), notamment : ./images.
Il contient l'entête HTML de l'article offline : <head>, la feuille de style...
Il contient également la mise en page des licences offline (les sept types de licence).
III-L. DeveloppezOnLine.xsl
Il permet la construction de l'entête PHP, la création des variables d'entête ($rubrique, $titre_page...). Il permet la mise en place des balises xiti perso, de la balise phpmyvisites de visites.developpez.com.
Il gère l'affichage des logos de validité XHTML et CSS et fais appel aux fonctions :
- licence ;
- reference ;
- bookmarks ;
- faitonclick (Création d'un lien Onclick de téléchargement) ;
- rubriquexiti.
III-M. Faq.xsl
Plus tard !
III-N. FaqFindFaq.xsl
Plus tard !
III-O. FaqIndexOnLine.xsl
Plus tard !
III-P. FaqQuestions.xsl
Plus tard !
III-Q. FaqQuestionsOffLine.xsl
Plus tard !
III-R. FaqQuestionsOnLine.xsl
Plus tard !
III-S. FaqSommaire.xsl
Plus tard !
III-T. FaqSommaireOffLine.xsl
Plus tard !
III-U. FaqSommaireOnLine.xsl
Plus tard !
III-V. FaqStatsOnLine.xsl
Plus tard !
III-W. FaqStatsXmlOnLine.xsl
Plus tard !
III-X. Livres.xsl
Plus tard !
III-Y. LivresIndexOnLine.xsl
Plus tard !
III-Z. LivresOnePageOnLine.xsl
Plus tard !
III-AA. LivresSommaireOnLine.xsl
Plus tard !
III-AB. LivresStatsXmlOnLine.xsl
Plus tard !
III-AC. Livresutils.xsl
Plus tard !
III-AD. References.xsl
Plus tard !
III-AE. Sommaire.xsl
Ce fichier contient une fonction summary et permet de générer le sommaire de la page Web d'un article monopage.
III-AF. Texte.xsl
Il contient une fonction de remplacement de chaine nommée string-replace-all.
Ce fichier permet de construire :
- les renvois ;
- renvois vers notes de fn de pages ;
- les balises :
- b;
- u;
- important ;
- italique ;
- font ;
- inline ;
- br ;
- sup ;
- sub ;
- img dans le texte ;
- signet.
Il contient les fonctions :
III-AG. Tutoriel.xsl
Il contient les fonctions :
- tutoriel : Mise en page du tutoriel ;
- soustitre ;
- sommaire ;
- blockquote ;
- colonne ;
- telechargement : pour la construction des liens téléchargement du PDF, ZIP et eBooks.
Il permet de construire la balise :
- animation : gestions d'une certaines liste de formats de vidéos ;
- signet ;
- code ;
- paragraphe de texte ;
- citation ;
- liste ;
- éléments de liste ;
- tableau ;
- ligne d'un tableau ;
- entête ou libellé d'un tableau ;
- colonne d'un tableau (entete) ;
- colonne d'un tableau (ligne) ;
- image ;
- section (chapitre, sous-chapitre...) ;
- imgtext ;
- rich-imgtext ;
- gras.
IV. Répertoire /racine/KIT/XSD
IV-A. article.xsd
IV-B. faq.xsd
IV-C. livre.xsd
IV-D. livres.xsd
IV-E. references.xsd
IV-F. sources.xsd
IV-G. texte.xsd
IV-H. types.xsd
Copyright © 2012 djibril.
Aucune reproduction, même partielle, ne peut être faite
de ce site ni de l'ensemble de son contenu : textes, documents, images, etc.
sans l'autorisation expresse de l'auteur. Sinon vous encourez selon la loi jusqu'à
trois ans de prison et jusqu'à 300 000 € de dommages et intérêts.