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…

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.

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.