lundi 7 novembre 2005

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.

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.

Dans SPIP, il y a généralement un couple .php3/.html par page du squelette.

Squelettes de la distribution de SPIP

Ils se trouvent dans le dossier 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
sommaire_texte.html Le sommaire du site dans un format texte simplifié (essai (à mon avis) raté d’accessibilité)

Faire vos squelettes SPIP

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

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

En principe, vous n’avez pas besoin de toucher aux fichiers .php3 placés à la racine du site.