Variations sur la dist : des clefs pour personnaliser son site

Une rubrique d’exemples pour mieux comprendre comment personnaliser les squelettes proposés par défaut avec SPIP 1.9.

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].

Variation sur la dist - exemple
source : peupleloup.info

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.

Variation sur la dist - exemple

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 !

Le chantier « Fraichdist »

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 »

Notes

[1Le moyen le plus pratique est de partir de copies de fichiers de la dist pour vos personnalisations à placer dans votre dossier « squelettes »

[2A propos de la courbe d’apprentissage de SPIP, voir ce message historique d’ARNO, un des créateurs de SPIP, sur la liste spip-dev (à remettre dans le contexte de l’époque bien sûr). Voir aussi l’analyse fort pertinente de diala

[3Pour illustration le squelette 2007 de SPIP-Contrib est développé ainsi petit à petit à partir de la dist

[4La difficulté, pour qui débute à vouloir faire son site, est que beaucoup de notions nouvelles sont en jeux, qui dépassent d’ailleurs souvent le seul cadre de SPIP, et concernent autant le fond que la forme : analyse de ses besoins propres, créer et structurer le contenu, notions d’ergonomie de graphisme ou de mise en page, contraintes techniques spécifiques au web, animation éditoriale, maîtrise des outils, hébergement, etc ... aussi il est important de faciliter ce contact autant que faire ce peut, mais sans créer pour autant de situation bloquantes pour l’avenir

Discussion

Aucune discussion

Ajouter un commentaire

Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :

  • Désactiver tous les plugins que vous ne voulez pas tester afin de vous assurer que le bug vient bien du plugin X. Cela vous évitera d’écrire sur le forum d’une contribution qui n’est finalement pas en cause.
  • Cherchez et notez les numéros de version de tout ce qui est en place au moment du test :
    • version de SPIP, en bas de la partie privée
    • version du plugin testé et des éventuels plugins nécessités
    • version de PHP (exec=info en partie privée)
    • version de MySQL / SQLite
  • Si votre problème concerne la partie publique de votre site, donnez une URL où le bug est visible, pour que les gens puissent voir par eux-mêmes.
  • En cas de page blanche, merci d’activer l’affichage des erreurs, et d’indiquer ensuite l’erreur qui apparaît.

Merci d’avance pour les personnes qui vous aideront !

Par ailleurs, n’oubliez pas que les contributeurs et contributrices ont une vie en dehors de SPIP.

Qui êtes-vous ?
[Se connecter]

Pour afficher votre trombine avec votre message, enregistrez-la d’abord sur gravatar.com (gratuit et indolore) et n’oubliez pas d’indiquer votre adresse e-mail ici.

Ajoutez votre commentaire ici

Ce champ accepte les raccourcis SPIP {{gras}} {italique} -*liste [texte->url] <quote> <code> et le code HTML <q> <del> <ins>. Pour créer des paragraphes, laissez simplement des lignes vides.

Ajouter un document

Suivre les commentaires : RSS 2.0 | Atom