Warning: filemtime(): stat failed for /home/developpez/www/developpez-com/upload/djibrilhttp://www.developpez.com/template/kit/article.css in /home/developpez/www/developpez-com/template/entete.php on line 405
IdentifiantMot de passe
Loading...
Mot de passe oublié ?Je m'inscris ! (gratuit)

Documentation technique XSL/XSD du kit de génération

Explication des fichiers XSL/XSD

Date de publication : 31/03/2012.

Par djibril Site personnel

 

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 contient la variable baseimages contenant le chemin WEB vers les images serveur d'un article : http://www.developpez.be/images/.

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 :

  • lien-forum ;
  • link.

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



Valid XHTML 1.0 TransitionalValid CSS!

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.