Éducation, société et technologie
Squelette AHUNTSIC

Personnalisation avancée

style ou variante de personnalisation
mardi 21 novembre 2006

Documentation et instructions pour modifier et personnaliser les squelettes d’AHUNTSIC.

 Pré-requis

 Avertissement

Le jeu de squelettes AHUNTSIC a été conçu pour permettre la mise en place rapide d’un site Web dynamique, communautaire, organisationnel ou institutionnel. Il a également été conçu pour autoriser à la fois la plus grande souplesse possible quant aux personnalisations désirées, mais également une capacité de suivre l’évolution et le développement des nouvelles fonctionnalités apportées au jeu de squelettes, à SPIP ainsi qu’aux nombreux greffons (plugins) développés pour SPIP.

Le jeu de squelettes offre déjà de nombreuses variantes, soit par mot-clé, soit par options de configurations ou activation de greffons (plugins) dans l’espace privé ou encore par l’insertion de raccoucis/modèles dans le texte des articles, rubriques, etc.

La personnalisation avancée dont il est question dans le présent article concerne la modification ou l’ajout de fichiers squelettes.

Pour préserver la capacité d’évolution du présent jeu de squelettes nous recommandons FORTEMENT :

  1. de ne PAS modifier AUCUN des fichiers de distribution du présent jeu de squelettes placé dans le dossier des (/plugins/) et dont nous allons détaillé la structure.
  2. de bien assimiler les mécanismes standards de surcharge et de chemin d’accès aux fichiers de squelettes utilisés par SPIP.
  3. de toujours placer vos modifications et personnalisations du jeu de squelettes, des greffons ajoutés ou même de SPIP, dans le dossier /squelettes/ à la racine de votre installation de SPIP.
  4. En conséquence, ne JAMAIS modifier directement les fichiers de la distribution du jeu de squelettes AHUNTSIC, des greffons ou de SPIP.

En fait, notre jeu de squelettes n’utilise rien de très sophistiqué, il n’utilise que de la façon la plus optimale possible les fonctionnalités de base de SPIP et des recommandations normatives du Web.

 Structure des dossiers

La distribution complète du squelette AHUNTSIC installé selon la méthode automatique proposée, comprend les fichiers et dossiers (ou répertoires) significatifs suivants :

  • plugins/
    • auto/
      • ahuntsic/
        • 404.html
        • ...
        • inc/
        • ...
        • rubrique.html
        • site.html
        • sommaire.html
        • ...
        • styles/
        • styles.html
        • ...

 Comment SPIP s’y retrouve-t-il

Tout le mécanisme du squelette AHUNTSIC repose sur la méthode utilisée par SPIP pour retrouver le chemin d’accès à un fichier squelette.

Prenons un exemple concret.

Si un squelette article.html se retrouve dans divers dossiers susceptibles de contenir des squelettes, lequel sera priorisé et ultimement utilisé, en lieu et place de tous les autres ?

Le mécanisme standard de SPIP (spip_path) établit ainsi sa recherche : le premier trouvé dans l’ordre suivant, est utilisé.

  • dans tout dossier déclaré comme dossier squelettes dans le fichier mes_options.php placé dans le dossier racine /config/. Le présent squelette n’utilise pas ce mécanisme, nous allons donc l’ignorer pour la suite des choses, mais c’est bon à savoir.
  • dans le dossier /squelettes/ créé à la racine de SPIP,
  • dans un des plugins déclaré et activé du dossier /plugins/. La recherche dans le dossier /plugins/ procède alphabétiquement. Si le fichier est trouvé dans le dossier a, il sera utilisé en priorité sur celui du dossier b,
  • puis, dans le dossier /squelettes-dist/,
  • et enfin, à la racine de SPIP ./.

Dans le cas du squelette AHUNTSIC, SPIP cherchera donc le fichier article.html par ordre de priorité dans les dossiers suivants :

  • ./squelettes/
  • ./plugins/auto/ahuntsic/ - (si activé, évidemment)
  • ./plugins/.../ - (autres plugins, si activés)
  • ./squelettes-dist/
  • ./

 Créer vos fichiers de personnalisation

Pour personnaliser le squelette AHUNTSIC, il suffit donc de copier l’un quelconque des squelettes AHUNTSIC ou de ses variantes dans le dossier /squelettes/ à la racine de SPIP, et de le modifier en conséquence. Tout fichier de squelette ainsi créé dans le dossier /squelettes/ sera utilisé en priorité sur tout autre fichier du même nom se trouvant dans le dossier /plugins/. Il est toutefois impératif de respecter l’arborescence des dossiers du squelette /ahuntsic/. Ainsi, si on veut modifier le pied-de-page, il faut dupliquer le fichier approprié dans /squelettes/inc/inc-bas.html.

Pour modifier les feuilles de styles, vous pouvez créer dans le dossier /squelettes/styles/ une feuille de styles portant très exactement les noms suivants : /squelettes/styles/perso.css et y ajouter uniquement les règles et propriétés de styles que vous désirez modifier. Ces règles viendront s’ajouter ou remplacer celles des feuilles de styles utilisées par le jeu de squelettes.

Pour plus de détails sur les feuilles de styles personnalisées, voir : Personnaliser les feuilles de styles

Attention : moins vous dupliquez de fichiers de personnalisation dans le dossier /squelettes/, plus la maintenance sera facilitée lors des prochaines mises à jour du squelette AHUNTSIC.

Questions et réponses sur le FORUM des utilisateurs


Accueil | Contact | Plan du site | | Statistiques du site | Visiteurs : 31447 / 1789533

Suivre la vie du site fr  Suivre la vie du site Ressources  Suivre la vie du site Squelette AHUNTSIC   ?    |    titre sites syndiques OPML   ?

Site réalisé avec SPIP 3.1.4 + AHUNTSIC

Creative Commons License

Visiteurs connectés : 2