Thèmes
Cette page est destinée à la personnalisation ou la création de thèmes. Si vous cherchez des thèmes déjà réalisés, référez-vous à la documentation Habillage du blog.
Guide d'utilisation des templates
Mécanique générale
Chaque thème est un ensemble de fichiers rangés dans un sous répertoire de /thèmes sur votre installation Dotclear. Ce sont ces fichiers qui, une fois interprétés par le moteur de template, vont produire les pages HTML en façade de votre blog. Vous trouverez ci-dessous le détail des différents fichiers
Organisation des fichiers
La fiche d'identité du thème
Nommé _define.php ce fichier accueille le nom du thème, sa description, son auteur et son numéro de version.
Les fichiers de « contexte »
Note :
Depuis la version RC1, ces fichiers doivent être rangés dans un sous-répertoire nommé tpl, dans le répertoire du thème. Pour l'instant, Dotclear se satisfait de l'ancienne organisation (tous les fichiers à la racine du répertoire du thème), mais la version finale s'attendra à les trouver bien rangés.Ils seront appelés en fonction du contexte de la page dont on demande l'affichage
- les news : home.html
- le billet seul : post.html
- le tri par catégories : category.html
- tous les mois comportant des billets : archive.html
- les archives d'un mois : archive_month.html
- liste de tous les tags : tags.html
- tous les billets d'un tag : tag.html
- les résultats d'une recherche : search.html
- 404.html : la page appelée en cas d'erreur
Chaque plugin créant un autre contexte doit prévoir son propre fichier .html. C'est le cas pour ceux par exemple des plugins dayMode et authorMode.
Les fichiers inclus dans les « fichiers de contexte »
Certains éléments sont récurrents, autant les faire une bonne fois pour toutes et les inclure dans la page de contexte qui nous intéresse. Ce sont les fichiers dont le nom est précédé d'un underscore. Exemple _footer.html.
- le pied de page : _footer.html
- l'appel des feuilles de style : _head.html
- le lecteur .mp3 : _mp3_player.html
- l'entête du blog : _top.html
Astuce :
Une class spécifique est attribuée à la balise <body> pour chaque fichier contexte ; on peut donc très facilement modifier la présentation d'un contexte spécifique à l'aide de cette class.Astuce :
Rien n'empêche de retirer l'appel à un fichier inclus pour placer directement dans tel ou tel contexte un contenu qu'on voudrait différent uniquement pour ce contexte. - rien n'empêche non plus de créer un fichier _pouetpouet.html à inclure dans les fichiers contexte pour un élément que vous voudriez récurrent.Ordre de lecture des fichiers
Le moteur va chercher le fichier dont il a besoin d'abord dans le répertoire du thème désigné par l'utilisateur. S'il ne s'y trouve pas, il ira piocher dans le répertoire du thème par défaut.
Note :
Le cas des templates des flux Atom et RSS est un peu plus particulier. Ceux-ci sont situés dans le repertoire inc/public/default-templates. Rien n'empêche bien sûr de les ajouter à son propre thème pour les remplacer.Deux choses en découlent :
- si l'on ne veut modifier la structure que d'un contexte il suffit d'ajouter son fichier personnalisé dans son répertoire de thème
- il est inutile, voire contre-productif de créer un thème depuis la copie complète de tous les fichiers du thème par défaut.
à compléter