Introduction

Les thèmes ont pour but de permettre à tout utilisateur de modifier très simplement l’habillage graphique de son site sans modifier les fichiers source du squelette. Cette fonctionnalité est disponible depuis la version 3.0.2 de Sarka-SPIP.

Chaque thème de la galerie affichée par le plugin Zen Garden est composé d’un ensemble de fichiers qu’il suffit d’installer dans le répertoire themes/ à la racine du site SPIP : voir à ce propos l’article Installer les thèmes de Sarka-SPIP. On distingue :

• des fichiers de description du thème comme le « plugin.xml » et la vignette, permettant à Zen Garden d’afficher l’ensemble des informations disponibles sur le thème
• des fichiers source, comportant sous différents formats les éléments nécessaires au squelette pour en personnaliser l’apparence. Ils sont en général rangés dans des sous-répertoires respectant la hiérarchie du squelette Sarka-SPIP.

  

Le fichier plugin.xml

Comme tout fichier xml celui-ci est composé d’un certain nombre de balises, parmi lesquelles :

• le nom du thème,
• le nom de l’auteur,
• une brève description du thème pour laquelle il est recommandé d’indiquer tout élément pertinent pour l’utilisateur,
• le nom de la vignette qui servira d’aperçu dans la galerie,
• l’état du thème, stable, en test ou en développement,
• l’indication de compatibilité dont les attributs précisent clairement que les thèmes sont uniquement destinés à être utilisés avec Sarka-SPIP 3,
• et la catégorie à savoir toujours la valeur « theme ».

La vignette

Celle-ci doit mesurer 200x150 pixels. Cette image, en général un jpeg ou un png, doit permettre d’illustrer rapidement le thème, ses couleurs, son ambiance.

Les images

Ce sont, soient les images d’arrière plan utilisées dans la page de configuration « Styles » de Sarka-SPIP, soient les icônes qui agrémentent les pages du squelette. Ces icônes sont déjà proposés en différents coloris, ce qui permet d’utiliser un des 11 jeux prédéfinis pour un thème donné.
Ces images sont regroupées dans le répertoire images/ du thème.

Les fichiers de configuration du squelette

Sarka-SPIP est un squelette entièrement paramétrable via ses pages de configuration. Lors du choix d’un thème Sarka-SPIP, Zen Garden lance automatiquement le chargement des pages de configuration incluses dans le thème choisi.

Même si il est possible d’inclure dans un thème quelconque des pages de configuration du squelette, toutes participent pas à la définition de l’habillage graphique du site : « agenda », « accueil », « colonnes »... doivent pouvoir être paramétrées indépendamment du thème. Par contre, les pages suivantes sont essentielles à la définition d’un thème car elles structurent le layout et les éléments graphiques du site :

• Configuration du layout : stockée dans le fichier sarkaspip_layout.txt, définit la structure fixe ou fluide du site et l’organisation des colonnes.
• Configuration du bandeau : stockée dans le fichier sarkaspip_bandeau.txt, définit les zones et les éléments composant le bandeau.
• Configuration du pied : stockée dans le fichier sarkaspip_pied.txt, définit les éléments constitutifs du pied de page
• Configuration des styles : stockée dans le fichier sarkaspip_styles.txt, définit l"ensemble des couleurs, éléments typographiques et images de fond constituant l’habillage graphique du site.
• Configuration des coins arrondis : stockée dans le fichier sarkaspip_coins.txt, a pour but, en général, d’interdire l’utilisation des coins arrondis, le thème devant privilégier la technique des images de fond.

Ces fichiers sont stockés dans le répertoire cfg/ du thème. En général, il n’est pas recommandé de modifier a posteriori la configuration de ces pages, sauf pour des paramètres affichant des données comme la licence du site, par exemple.

La noisette de copyleft

Pour respecter les droits d’auteur sur les thèmes, il est obligatoire de fournir avec le thème un fichier de copyleft, définissant les crédits et mentions légales associés au thème. Ce fichier rajoute une troisième ligne dans le pied de page du site qu’il n’est pas possible de supprimer via la configuration du squelette. Ne la supprimez pas donc, les auteurs vous en seront reconnaissants !

Cette noisette est stockée dans le répertoire noisettes/pied/ du thème et se nomme inc_pied_habillage.html.

Conclusion

Les fichiers d’un thème sont distribués dans une archive Zip par thème. Il existe aussi une archive de tous les thèmes de Sarka-SPIP.

Si maintenant vous souhaitez participer à l’aventure des thèmes de Sarka-SPIP, consultez l’article Créer un thème pour connaître la démarche de création d’un thème.