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.
Article publié le 20 mai 2012, et actualisé en juillet 2016 .
Répondre à cet article