Lundi 7 novembre 2005 — Dernier ajout vendredi 29 juillet 2011

Squelette SPIP, par où commencer ?

La découverte de SPIP bloque parfois sur des concepts qui paraissent tellement évidents après coup qu’ils sont difficiles à trouver dans la documentation…

Par où commencer dans un squelette fait partie de ces concepts.

Retour Sommaire

Un peu d’histoire

Au commencement était le HTML.

Puis SPIP est venu pour séparer le HTML du contenu.

Donc, dans SPIP :

  • le contenu est géré par l’interface d’admin de SPIP
  • et les squelettes qui sont du HTML avec des BOUCLES et des BALISES SPIP affichent à l’internaute le contenu du site.

Les squelettes sont donc du HTML passant à la « moulinette » de SPIP pour produire le résultat vu par les internautes.

Retour Sommaire

Squelettes principaux de la distribution de SPIP

Ils se trouvent dans le dossier squelettes-dist/ de SPIP

Les squelettes de SPIP
Nom du fichier Rôle du fichier
404.html Page d’erreur 404 : « non trouvé »
agenda.html Agenda du site (articles placés par date de publication)
agenda_jour.html Agenda : détail du jour
agenda_mois.html Agenda : détail du mois
agenda_periode.html Agenda : détail sur une période
agenda_semaine.html Agenda : détail de la semaine
article.html Pour l’affichage d’un article particulier du site
auteur.html Pour l’affichage d’un auteur particulier du site
backend-breves.html Fichier générant le RSS des brèves
backend.html Fichier générant le RSS des articles
breve.html Pour l’affichage d’une brève particulière du site
distrib.html Fichier générant un pseudo RSS des articles sous forme d’un javascript
forum.html Permet de poster un message dans un forum du site
ical.html Permet de synchroniser un agenda local avec les articles du site (format iCal)
login.html Page de login du site
mot.html Pour l’affichage d’un mot clef particulier du site
nouveautes.html Pour le mail des nouveautés du site
plan.html Le plan du site
recherche.html Le résultat d’une recherche sur le site
resume.html Le résumé du site (articles les plus populaires)
rubrique.html Pour l’affichage d’une rubrique particulière du site
site.html Pour l’affichage d’un site référencé particulier du site
sommaire.html La page d’accueil du site
Retour Sommaire

Faire vos squelettes SPIP

Vos squelettes devront être dans un dossier nommé squelettes/ placé à la racine de votre site (au même niveau que squelettes-dist/).

Si vous n’avez pas de squelette pour un élément (site.html par exemple), SPIP prendra par défaut celui du dossier squelettes-dist/.

Le principe général est de :

  • placer votre fichier HTML dans le dossier squelettes/ en lui donnant le nom du squelette idoine (sommaire.html pour la page d’accueil)
  • placer tous les médias (CSS, images, javascripts) dans des sous dossiers de squelettes/
  • de remplacer dans votre HTML tous les appels aux médias par une recherche de ceux-ci avec la balise #CHEMIN [1]
  • Remplacer dans le HTML tout ce qui est des faux textes par des boucles et balises pour afficher le contenu désiré
  • Ne pas oublier les éléments à modifier ou mettre dans le <head>
  • Et cerise sur le gâteau, utiliser INCLURE pour mutualiser ce qui est commun au titre près dans tous les gabarits HTML.

Vous lirez aussi avec profit Les outils pour développer avec SPIP.

Retour Sommaire

Quelques ressources en ligne :

Et bien sûr, vous pouvez demander de l’aide.

[1Ceci permet de vérifier que l’affichage brut se fait avec le bon look.