Table des matières
Un style par espace de nom
L'objectif
Je dois reconnaître que j'ai beau pratiquer DokuWiki depuis maintenant un bon moment, je ne comprends toujours pas que rien ne soit prévu pour adapter un minimum le style (au minimum l'éventuelle bannière voire le logo, ou mieux le CSS) en fonction de l'espace de nom en cours de consultation. Mais puisque sur ce sujet, personne ne réagit sur la mailing list dédiée aux développeurs, je suppose que je suis un Alien avec des idées bizarres…
Les images
C'est l'aspect le plus simple à modifier car il “suffit” de bidouiller un thème. Pour faire les choses proprement, et moins subir les mises à jour du thème, il faut en fait conserver le thème original, en faire une copie sous un autre nom et travailler sur cette version privée du thème.
Créer son propre thème
Il existe un guide et de nombreuses informations sur la manière de procéder pour créer un thème « from scratch » en partant du modèle Starter mais cela concerne la création d'un thème complet (Starter ne contiens vraiment que le minimum et partir de là consitue un très gros projet). Mais la méthode reste valable pour ceux qui souhaitent juste apporter quelques modifications à un thème existant :
- dans la répertoire
…/lib/tpl
, faire une copie du thème que l'on souhaite modifier (par exemple dokuwiki) - renommer ce dossier en respectant les règles suivantes : n'utiliser que des minuscules, pas de caractères accentués (il me semble), pas d'espace ni d'underscore. Et non, je sais que c'est triste mais, mais vous ne pouvez pas nommer votre thème Mon Thème Qui Déchire Sa Race, il faudra se contenter de
monthemequidechiresarace
. - ouvrez le fichier
…/lib/tpl/monthemequidechiresarace/template.info.txt
pour l'adapter à vos besoins :
base monthemequidechiresarace author Toto email toto@totos.fr date 2015-08-27 name Mon Thème Qui Déchire Sa Race desc Un thème rien que pour moi. url https://peu.importe
Le seul élément important est le champs base (qui doit être rigoureusement identique au nom choisit pour le dossier à l'étape précédente).
Et voilà ! … Le thème monthemequidechiresarace
est disponible dans le sélecteur de thème de DokuWiki.
Il ne reste plus qu'à y apporter les modifications voulues.