{{tag>dokuwiki wiki php css thème style}}
<WRAP hide>
== Un style par espace de nom ==
</WRAP>

====== 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... LOL

===== 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 [[dw>https://www.dokuwiki.org/devel:templates|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 :

<code>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</code>

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. 8-)

Il ne reste plus qu'à y apporter les modifications voulues.