INCLURE

  Balises #INCLURE


Les balises INCLURE permettent d’insérer automatiquement un morceau de code squelette dans la composition d’une page de votre site, ce que spip appelle une noisette.

Cette instruction #INCLURE ou <INCLURE vous permet facilement de ré-utiliser un pavé de texte HTML, isolé dans un fichier, pour construire plusieurs de vos pages...

 
 
 
 
 
 
 
 

Utiliser un INCLURE, c’est automatiser un "coupe-coller" d’un bout de squelette dans toutes les pages où vous voulez le ré-utiliser.

 Inclure quoi ?

On va demander de faire l’inclusion d’un texte HTML, trouvé dans un fichier de votre dossier squelette.

Donc, il faut bien indiquer le nom de ce fichier à inclure, donné comme "fond" de squelette.

La commande INCLURE s’écrit donc sous la forme :

#INCLURE{fond=noisette}

pour inclure un fichier noisette.html que SPIP cherchera automatiquement dans votre dossier squelettes, avec l’extension .html [1]

N.B. : le ’compilateur’ des squelettes de SPIP s’attend a traiter de simples fichiers HTML, donc il rajoute automatiquement l’extension .html aux noms de noisettes fournies ; des fichiers inclus, mais avec d’autres extensions (non terminées par l’extension .html) ne seront pas interprétés par le compilateur, mais seront néanmoins insérés comme texte dans la page finale

 Deux écritures

Vous aurez remarqué deux syntaxes dans les lignes ci-dessus, que nous pourrons considérer comme équivalentes [2] :
- l’une <INCLURE> utilise l’encadrement par les chevrons simples, en restant homogène à la syntaxe déjà utilisée pour LES BOUCLES ; le squelette est donc géré en autonome, dynamiquement en fonction de l’environnement transmis par {env}.
- l’autre #INCLURE utilise le préfixe dièse, déjà vu pour identifier les zones de champs tirés de la base de donnée des textes ; on parle d’une inclusion statique, car son source est inséré dans le squelette appelant avant compilation.


Merci de nous signaler les coquilles ou erreurs qui figureraient dans cette page.

[1Attention aussi à bien enregistrer votre fichier avec extension en minuscules !

[2La différence porte sur le caché résultant, propre au <INCLURE{ et inclus dans l’appelant pour #INCLURE..


Liens visibles seulement pour les inscrits.

Article publié le 20 mai 2012, et actualisé en juillet 2016 .

Répondre à cet article