C’est quoi la « dist » ?
La dist
La « dist » est le jeu de squelettes par défaut proposé avec la distribution standard de SPIP. Volontairement d’apparence très sobre, ces squelettes sont en fait très riches en possibilités, en phase avec les derniers développements de SPIP (puisque la dist fait partie du Core de SPIP), très structurés au niveau du code, conformes aux standards du web, et souvent pédagogiques (les boucles de SPIP, les feuilles de style CSS, par exemple).
Pouvoir modifier progressivement
Une possibilité remarquable (et pas toujours bien comprise) c’est que du fait de dispositions du code de SPIP associées à cette dist, il est possible de personnaliser son site pour un effort raisonnable et progressif. Créez, s’il n’existe pas déjà, un répertoire dénommé très exactement « squelettes » à la racine de votre site, et glissez y les seuls éléments de squelettes que vous souhaitez modifier (par exemple votre bandeau de tête, ou votre feuille de style, ou sommaire.html, etc ...). SPIP comprendra tout seul qu’il doit prendre en compte ces éléments en priorité, et pour tout ce qui manque ira automatiquement piocher dans la dossier de la dist.
Le point « très » important qui en découle est que, si vous avez fait l’effort de respecter l’organisation de la dist (les conventions de noms, la structure des pages et des inclusions, etc ..) lors de vos adaptations [1], vous bénéficiez dès le départ d’un site à la fois complètement opérationnel et à la fois personnalisé, sans avoir à tout créer. Dès lors vous pourrez progressivement l’adapter au fur et à mesure de votre apprentissage et de la découverte de vos besoins, le tout bien sûr sans remettre en cause vos données (puisque celles-ci sont dans la base de données, séparées des informations de mise en forme).
Une courbe d’apprentissage progressive
C’est la notion de courbe d’apprentissage progressive chère aux développeurs de SPIP [2], qui demande certes un peu d’effort dès le départ, mais en contrepartie permet de maitriser son site, et évite ensuite les pics brutaux de compétences nécessaires qui peuvent bloquer toute évolution [3].
A propos des CSS de la dist
La documentation de référence offre tout ce qui est nécessaire pour personnaliser votre site à partir de la dist :
l’adaptation des boucles : Boucles et balises : manuel de référence
La documentation officielle pour l’adaptation de vos styles : Habillage graphique « Pour réaliser l’habillage de votre site, il est recommandé d’utiliser les feuilles de style CSS. Pas de panique, ces quelques pages permettront aux débutants de raccrocher les wagons... »
Des compléments sur l’organisation des pages de la dist : Modèle de mise en page, Quelques lignes directrices..., À propos du style dans les formulaires de Spip
les contributions de SPIP-Contrib bien sûr (dont le le contenu de la présente rubrique)
Il va de soi, qu’un minimum de compréhension de ce que sont les feuilles de style CSS est nécessaire, mais cela dépasse le seul cadre de SPIP
Variations sur la dist - Une rubrique d’exemples commentés
Cependant il faut avouer que pour un débutant (au web ou à SPIP) cette documentation, si elle n’est pas accompagnée, est un peu rude comme premier contact de par sa densité [4].
L’objectif de cette rubrique « Variations sur la dist » est justement de proposer des exemples commentés de tels travaux.
Cette rubrique étant avant tout destinée aux nouveaux venus, aussi l’approche sera le plus didactique possible. Il ne s’agit pas ici de refaire une documentation générale déjà existante par ailleurs (poser des liens dessus sera utile par contre), mais plutôt d’expliquer le pas à pas de certaines modifications apportée à la dist, et restant dans le cadre de celle-ci.
Pour en savoir plus
Des chantiers en germe
L’organisation de la dist porte aussi en germe d’autres évolutions, mais qui sortent du cadre de cet article. Exemple de recherche associée : le Plugin Sktheme, voir aussi Et maintenant ? rhabillons la dist !
Petit historique
Pour mémoire rappelons que la dist actuelle (juin 2007) est issue du projet « FraichDist ». Cette démarche illustre bien les apports possibles, et parfois imprévisibles au début, que l’on peut faire au projet SPIP. Quelques liens pour en savoir plus :
le rappel historique d’ensemble : Bye-bye FraichDist !
le logo du présent article est celui du projet « FraichDist »
ce qui est écrit dans les squelette (partie statique des patrons)
RSS 2.0