INCLURE

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 :

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 le texte de la noisette source est inséré dans le fichier squelette appelant, avant sa compilation.