Avertissement : Cette version n’est pas la plus récente. Voir ici : toutes les versions du squelette

Présentation

Ce squelette, sous licence GPL, s’applique à un site réalisé avec SPIP (à partir de la version 1.8.2e) comme sur ce site de démonstration avec les navigateurs actuels : IE, Firefox, Safari, Opéra, Mozilla. Le squelette :

 s’installe immédiatement, par simple dépôt de fichiers
 n’exige qu’un changement de Logo pour être personnalisé
 propose des options (agenda, album...)
 peut mettre en place les options automatiquement
 est extensible, sans modification du squelette

Changements

Les différences par rapport à v3.0 :

 extensibilité du squelette avec des variantes d’articles et rubriques,
 intégration de l’excellent album Walma comme variante,
 adaptation du configurateur (et correction d’un petit bug de lien),
 images de logo à fond neutre, prêtes à personnaliser,
 prise en compte des balises de sites pour article
 ajout puce dans les encarts

---

1. Caractéristiques

Le menu de navigation

Ce menu de navigation dynamique, présent sur toutes les pages du site, est réalisé en CSS sans Javascript, ce qui lui permet de s’intègrer au HTML et à Spip. Le menu initiallement installé permet de naviguer dans les rubriques du site et d’accèder à l’agenda s’il existe. Il permet toutefois une personnalisation plus fine, notamment pour ceux qui ne souhaitent pas un menu répliquant l’organisation des rubriques. [1].

Note : Internet Explorer, ne sait pas rendre exactement l’image présentée au dessus mais le menu reste parfaitement exploitable.

L’agenda

L’agenda affiche des événements définis par une journée ou une plage de journées (3 semaines maximum), cela sous forme de calendriers mensuels et annuels, avec des possibilités de sélection et de navigation par mois ou années.

Le principe de réalisation est d’utiliser les articles Spip comme événements et certains de leurs attributs de la manière suivante :

 date antérieure : pour fixer la date de l’événement, [2]
 sous-titre optionnel : pour indiquer une plage de jours,
 mot-clés optionnel : pour permettre une sélection par mot-clé,
 rubrique de rattachement : pour permettre une sélection par emplacement.

Les deux derniers attributs (mot et rubrique) permettent des sélections qui correspondent chacune à un choix d’installation de l’agenda, à savoir :

 l’agenda mot : il permettra la sélection d’événements par mot-clé uniquement, quelle que soit leur rubrique de rattachement.

 l’agenda secteur : il permettra la sélection d’événements situés dans une branche du secteur Agenda (un secteur est une rubrique placée à la racine du site, avec des sous-rubriques éventuelles), qu’il y ait ou pas des mot-clés associés aux événements.

 l’agenda complet : il combine les 2 précédents en permettant la sélection d’événements par mot-clé à l’intérieur d’une branche du secteur Agenda.

	sélection par mot-clé	sélection par emplacement	Existe depuis
Agenda mot	oui	-	v3 (nouveau)
Agenda secteur	-	oui	v2
Agenda complet	oui	oui	v1

Un secteur Agenda est donc nécessaire pour les agendas secteur et complet tandis que un ou plusieurs mot-clés sont nécessaires aux agenda mot et complet ; ils seront à créer lors de la personnalisation du squelette.

Ici l’agenda miniature tel qu’il apparaît en page d’accueil. Les jours à événement contiennent un lien direct vers l’article-événement s’il est unique, ou alors vers la vue mensuelle lorsqu’il y a plusieurs événements.

Ci dessous, le calendrier en mode mensuel de l’agenda complet qui permet une navigation de mois en mois et aussi un Menu de sélection (positionné sur "Tout") qui va permettre un choix de mot clé et, tout en bas, les îcônes de sélection de branche (sous-secteur).

Dans le calendrier annuel, on retrouve le même principe de navigation qu’en mode mensuel. Cette présentation en liste permet le copier/coller.

Les 2 Albums

Ceci concerne les articles ayant des images (jpg, gif, png) en mode "Document" [3].

walma est un album sophistiqué, avec un mode diaporama, en libre diffusion. Il est présenté "ici" sur son site d’origine et peut remplacer avantageusement l’ancien type d’album Epona.

album2 est l’ancien album Epona qui propose 2 présentations pouvant cohabiter sur un même article :

 album simple : 1 seule image par page ;
 album à vignettes : chaque page de l’album contient 1 bloc de vignettes et une image.

On peut ajouter à chaque article un (ou plusieurs) mot-clé, ce qui provoque l’insertion, dans l’article public, d’une (ou plusieurs) invite à l’ouverture d’album, chaque mot-clé correspondant à un type d’album différent comme dans cet exemple. album2 est lui-même extensible comme décrit plus loin.

Le configurateur

Il permet de créer l’Agenda et tous les mot-clés, de calculer un menu de navigation éditable et de revenir au menu par défaut.

Il ne peut être utilisé que par un administrateur SPIP et peut être appelé à tout moment. Le menu qu’il propose est fonction des éléments installés qu’il détecte.

Pour ceux qui préfèrent, le configurateur indique comment procéder manuellement (via Spip) à la création de l’Agenda et des mot-clés.

Extension du squelette

Spip permet déjà de créer des variantes d’articles ou de rubriques s’ils sont localisés dans une rubrique ou branche XX particulière (Cf. article=XX.html). Le squelette étend cette notion , le principe étant d’utiliser un mot-clé pour faire appel à une variante.

La première application de ce principe est pour le squelette lui-même ; c’est ainsi que l’ancienne page article.html a été sensiblement allégée grâce à la création de variantes spécialisées (voir ci-dessous). C’est un gain en performances et en simplicité.

Les autres applications sont ouvertes puisque vous pourrez créer vos propres variantes sans toucher au squelette.

Variantes intégrées

Les variantes qui suivent, nommées d’après leur mot-clé, viennent avec le squelette, comme alternatives à l’article ordinaire :

 livre : similaire à la page article ordinaire, sauf qu’il n’y a pas de possibilité de réponse sur un message déposé ; c’est le principe d’un livre d’or
 album2 : similaire à la page article ordinaire, mais les documents joints seront traités sous forme d’album comme expliqué ci-desssus
 walma : c’est l’album WALMA qui a été intégré à Epona au coût d’une seule ligne modifiée dans le walma.html d’origine.
 petition : pour présenter l’article en pétition

par_titre est la seule variante de rubrique : elle affiche les articles de la rubrique par ordre alphabétique et non chronologique comme pour la rubrique ordinaire.

Autres fonctions

La pagination s’applique à toutes les pages susceptibles de générer des listes volumineuses.

Les articles qui auront été marqués avec le mot clé cacher n’apparaîtront pas à la une.

Les sites qui auront été marqués avec le mot clé sommaire apparaîtront à la une.

Autres pages spécifiques à ce squelette :

 tous les articles (avec choix de critères statistiques)
 tous les forums,
 page équipe

---

2. Installation ou mise à jour

Prérequis

 Tout d’abord, SPIP v1.8.2e minimum, doit avoir été installé sur votre site.

 en cas de première installation Epona sur un site déjà existant, vérifiez qu’il n’y a pas de conflit de noms avec vos éléments ; au besoin, renommez les. Il s’agit du secteur Agenda et des groupes de mots Agenda, _Agenda, Epona, Album, _Article, _Rubrique

 Si vous utilisez un squelette Epona v2, renommez d’abord le mot clé Agenda du groupe Agenda avec agenda_secteur ou agenda_complet suivant que vous aviez un agenda "simple" ou "complet". Vous devrez ensuite repasser par l’étape de personnalisation.

Par précaution, videz le cache Spip et pensez à sauvegarder votre mes_options.php3, s’il existe.

Installer

php3

php

 Placez une des archives à la racine du site,

 décompressez-la ; il y a création des éléments suivants :

Nom	description
squelettes/epona	dossier contenant le squelette
ecrire/mes_options.php3	fichier qui définit le dossier squelette
ecrire/epona_conf.php3	le configurateur

Le squelette est alors opérationnel et fonctionne à ce stade sans Agenda ni mot-clés. Vous pouvez appeler le configurateur http://.../ecrire/epona_conf.php3 pour activer ces fonctions en choisissant l’option qui vous convient parmi celles proposées.

Le configurateur permet de créer automatiquement tous les groupes de mot-clés qui manquent, ce qui couvre les cas de 1ère installation et de mise à jour.

Note pour une mise à jour : si vous utilisiez l’album Epona v2.x ou v3.0, vous devrez opter pour une variante d’album en ajoutant à vos articles d’album soit le mot-clé album2 soit le mot-clé walma (tous deux du groupe _Articles). Dans le cas walma, les anciens mot-clés vignette_images et album_simple ne servent plus et peuvent être retirés de l’article.

---

3. Personnalisation

Rien de ce qui suit n’est obligatoire si ce n’est l’adaptation du Logo. D’une manière générale, les fichiers du squelette sont commentés pour vous aider à aller plus loin, notamment pour optimiser les performances ou réintroduire les exclusions qui existaient en version 2.

Le Logo

Fichier	pour personnaliser
inc-logo.html	Adapter le texte éventuellement
logo.jpg	Remplacer l’image
inc-bandeau.html	Adapter éventuellement
gauche.jpg	Remplacer l’image
droit.jpg	Remplacer l’image

 inc-logo.html contient l’image en haut à gauche et le nom du site. Veuiller à ne pas dépasser la largeur d’origine (165px), faute de quoi il faudrait retoucher les CSS.

 inc-bandeau.html est le logo horizontal ; respecter la hauteur (147 pixels max). On peut se contenter d’une seule image centrale si elle est assez large.

 On peut aussi supprimer le bandeau de la page d’accueil en modifiant sommaire.html par suppression de la ligne qui contient inc-bandeau, et changer id="second" en id="principal" .

Feuilles de style

Si vous souhaitez d’autres formes et couleurs (celles d’origine sont #FFFFE0 pour le fond jaune clair et #CC4F4F pour le menu en bordeaux), vous pourrez modifier typoml.css et epona.css qui sont clairement commentés. Les styles de l’album sont directement insérés dans leurs fichiers html. De même pour la page WALMA (article-walma.html) complètement autonôme.

Agenda

Si vous avez opté pour l’agenda complet ou l’agenda mot, vous devez créer dans le groupe _Agenda (ne pas confondre avec Agenda également utilisé) les mots clés qui correspondent à vos besoins de sélection : ils apparaitront directement dans le menu de sélection. Ainsi, sur mon site hippique, ce menu propose ’Tout’, ’Poney’ et ’Cheval’. Ces deux derniers choix étant les mot-clés du groupe _Agenda.

Pagination

La taille de page peut être adaptée en modifiant le XX (dans debut_page,XX) ; recherchez ces valeurs dans rubrique.html, article.html, articles.html, forums.html, recherche.html, mot.html.

Pour changer la présentation des liens de navigation, reportez-vous ici. Le filtre qui réalise la pagination ne supporte pas les boucles imbriquées ni le critère doublons.

Pour les vignettes de l’album, la pagination est dans le fichier vignettes_album.html (debut_vignette,4 et define VIGNETTES_PAGE).

Le menu de navigation

Le menu de navigation dans inc-menu.html fonctionne avec de simples balises HTML ul / li en liaison avec des styles CSS. Il y a plusieurs possibilités d’utilisation :

 le menu de base initialement installé présentera vos rubriques par ordre alphabétique (par titre). C’est un fichier Spip classique que vous pourrez adapter avec d’autres boucles, critères et filtres.

 le configurateur, permet d’obtenir un menu identique à celui de base en créant un inc-menu.html en pur HTML, facile à modifier puiqu’il s’agit de balises ul / li présentées avec l’indentation qu’il faut. C’est indispensable pour ceux qui, comme moi, ne souhaitent pas un menu qui réplique le rubricage ; de plus l’affichage est plus rapide puisqu’il n’y a pas de code Spip ou php.

 la dernière solution est mixte ; c’est une page Spip makem qui crée le menu de base en pur HTML mais que vous pouvez modifier à la mode Spip, comme dans la première solution. Cette page étant dans l’espace public, il est prudent de la renommer avec un nom secret, sans oublier le suffixe .html. Par exemple azerty.html et vous pourrez l’appeler par : http://.../page.php3?fond=azerty après l’avoir modifié à votre goût pour créer le inc-menu.html voulu.

Note : Le configurateur permet de revenir au menu de base (copie de inc-menu_def.html dans inc-menu.html).

Dans tous les cas le menu donne accès aux pages d’agenda s’il existe.

Résumé des pour et contre de chaque solution

	Menu initial	Makem	Configurateur
Contrôle contenu	limité	oui	oui
Mise à jour	automatique	assistée	assistée
Performances	non	oui	oui
Codage	Spip	Spip	php

Extension de squelette

Pour ajouter une variante d’article, placez la nouvelle page article-XYZ.html dans le dossier squelette et ajoutez le mot-clé XYZ dans le groupe de mot-clé _Article.

Pour ajouter une variante de rubrique, placez votre nouvelle page rubrique-XYZ.html dans le dossier squelette et ajoutez le mot-clé XYZ dans le groupe de mot-clé _Rubrique.

Pour ajouter au squelette une nouvelle page de présentation XYZ.html de type album2, il faut juste la placer dans le dossier squelette epona et ajouter le mot-clé XYZ dans le groupe de mot-clé Album.

---

4. Utilisation

Vous quittez ici votre casquette Webmestre pour devenir auteur.

Utilisation de l’agenda

Vous devez au minimum avoir saisi un article (avec le bouton valider) pour qu’il soit connu de SPIP, en veillant à :

 le placer dans le secteur réservé à l’Agenda si vous avez un agenda secteur ou un agenda complet
 indiquer "N jours" quelque part dans le sous-titre de l’article si l’événement s’étale sur N jours consécutifs.

Effectuer ensuite ces actions, sans ordre particulier :

 renseigner la "date antérieure" de l’article avec la date de l’événement (déplier le menu, cocher Afficher puis renseigner J-M-A)

 pour l’agenda mot ou l’agenda complet : donner à l’article un ou plusieurs de vos mot-clés du groupe "_Agenda"

Si votre article ne s’affiche pas dans l’agenda après publication et recalcul de page, vérifiez bien tous les points ci-dessus.

Utilisation des variantes

Pour utiliser une variante existante XYZ, sélectionnez le mot clé XYZ (groupe de mot-clé _Article ou _Rubrique) pour votre article ou rubrique. Les possibilités déjà offertes pour les articles sont livre, petition, album2 et walma dans le groupe _Article ; pour les rubriques il y a par_titre dans le groupe _Rubrique.

La variante walma suppose que vous ayez préalablement joints des documents à votre article. Si vous avez un texte d’accompagement de l’album, faites en un article ordinaire qui fera référence à l’article album par un lien.

Pour la variante album2 il faut choisir la présentation par un ou deux des mots-clés du groupe Album : album_simple ou vignettes_images, ce dernier choix n’ayant un sens que pour les documents à vignette.

La variante petition ne suffit pas à faire apparaître la pétition : il faut aussi l’indiquer à Spip avec le menu "activer la pétition" de gestion de votre article.

Autres mot-clé (groupe mot Epona)

Utilisez le mot-clé cacher pour exclure un article de la page d’accueil.

Utilisez le mot-clé sommaire, pour afficher un site en page d’accueil.

---

5. Remerciements

Mes sources d’inspiration :

 Les squelettes de la distribution SPIP,
 "Réaliser un agenda avec SPIP" ,
 "Menu en cascade automatique",
 "Pagination",
 "Des boucles pour album photo".
 "comment faire un squelette facile à installer".
 "Galerie WALMA3"".

j’en remercie bien sincèrement leurs auteurs, ainsi que Jacques PYRAT qui m’a aidé à rendre générique l’installation de l’agenda.

Un merci aussi à tous ceux qui m’ont écrit et aidé par leur commentaires à améliorer le squelette, à ceux de la liste en particulier.

---

6. Autres liens

 la FAQ
 liste de discussion Epona
 des sites avec Epona
 toutes les versions du squelette (les futures seront ici)
 guide d’installation en local
 et moi