Cette page décrit comment personnaliser DokuWiki grâce aux templates.

Ce site utilise le template Arctic-mbo (basé sur Arctic).

Cette section décrit comment installer facilement le template de ce site.
Arctic-mbo est une modification du template Arctic qui ajoute notamment le menu de gauche.

La page concernant Artic-mbo sur le site officiel : http://www.dokuwiki.org/template:arctic-mbo
Le template originel Arctic est disponible ici : http://www.dokuwiki.org/template:arctic

Vous pouvez télécharger Arctic-mbo ici : arctic-mbo_2011-01-09.tgz

• 2011-01-09 : traduction de la sidebar et support de l'absence du plugin translation
• 2011-01-06 : première version

Pour l'installer il faut le décompressé dans lib/tpl :

:/opt/dokuwiki/lib/tpl# tar -zxvf /root/arctic-mbo_2011-01-06.tgz
arctic-mbo/
arctic-mbo/COPYING
arctic-mbo/Makefile
arctic-mbo/README
arctic-mbo/VERSION
arctic-mbo/_admin.css
arctic-mbo/_linkwiz.css
....

Installer également translation pour la traduction des pages (ce template peut également être utilisé sans).

Pour activer le template, il suffit d'utiliser la liste déroulante dans “Admin » Config Manager”

Modifier également les options suivantes :

• youarehere activé
• tpl»arctic»left_sidebar_content : ajout de “index” et “extra” (si vous ne voulez pas utiliser translation, extra n'est pas nécessaire)
• tpl»arctic»left_sidebar_order : extra,main,namespace,user,group,index

D'autres paramètres sont définis ici : Options

• appliquer le patch suivant pour modifier le youarehere en titre de la page : youarehere_2010-11-07.patch

:/opt/dokuwiki/inc# patch -p 1 < /root/youarehere_2010-11-07.patch
patching file template.php
:/opt/dokuwiki/inc#

• voici un patch de translation pour adapter le style au menu : translation_2010-12-10_arctic.patch

:/opt/dokuwiki/lib/plugins/translation# patch -p 1 < /root/translation_2010-12-10_arctic.patch
patching file style.css
:/opt/dokuwiki/lib/plugins/translation#

• enfin, si le plugin tag est installé, il faut également que le patch disponible ici soit appliqué.

Ce paragraphe explique comment installer la personnalisation à partir des sources d'Arctic.

Télécharger Arctic à partir de http://www.dokuwiki.org/template:arctic.
Les templates doivent être installés dans le sous répertoire lib/tpl :

:/opt/dokuwiki/lib/tpl# wget http://cloud.github.com/downloads/chimeric/dokuwiki-template-arctic/template-arctic.tgz
--2011-01-05 23:59:07--  http://cloud.github.com/downloads/chimeric/dokuwiki-template-arctic/template-arctic.tgz
Résolution de cloud.github.com... 216.137.59.72, 216.137.59.160, 216.137.59.232, ...
Connexion vers cloud.github.com|216.137.59.72|:80...connecté.
requête HTTP transmise, en attente de la réponse...200 OK
Longueur: 54514 (53K) [application/octet-stream]
Sauvegarde en : «template-arctic.tgz»

100%[======================================>] 54 514      --.-K/s   ds 0,02s

2011-01-05 23:59:09 (2,85 MB/s) - «template-arctic.tgz» sauvegardé [54514/54514]

z4:/opt/dokuwiki/lib/tpl# tar -zxvf template-arctic.tgz
arctic/
arctic/COPYING
arctic/Makefile
arctic/README
...

Pour activer le templace, il suffit d'utiliser la liste déroulante dans “Admin » Config Manager”

Une fois activé, des nouveaux paramètres spécifiques au template apparaissent dans le gestionnaire de configuration.

Voici les options sélectionnées pour ce wiki :

• tpl»arctic»left_sidebar_content : ajout de “index”

Ce site utilise le plugin translation pour la traduction des pages.

Pour ajouter les options dans le menu de gauche, créer le fichier lib/tpl/arctic/left_sidebar.html avec le contenu :

<?php
$translation = &plugin_load('helper','translation');
if ($translation) echo $translation->showTranslations();
?>

Puis ajouter “extra” dans tpl»arctic»left_sidebar_content.
Pour placer la traduction en haut du menu, modifier tpl»arctic»left_sidebar_order : extra,main,namespace,user,group,index

Enfin, voici un patch de translation pour adapter le style au menu : translation_2010-12-10_arctic.patch

:/opt/dokuwiki/lib/plugins/translation# patch -p 1 < /root/translation_2010-12-10_arctic.patch
patching file style.css
:/opt/dokuwiki/lib/plugins/translation#

Pour obtenir un wiki totalement semblable à celui-ci, il faut en plus appliquer les modifications suivantes :

• activer l'option youarehere
• remplacer lib/tpl/arctic/footer.html par 2011-01-06_footer.html
• appliquer le patch suivant modifiant l'ensemble du style : arctic_2011-01-06.patch

:/opt/dokuwiki/lib/tpl/arctic# patch -p 1 < /root/arctic_2011-01-06.patch
patching file arctic_design.css
patching file arctic_layout.css
patching file layout.css
patching file main.php
patching file style.ini
:/opt/dokuwiki/lib/tpl/arctic#

• appliquer le patch suivant pour activer la traduction de la sidebar : arctic-tpl_functions_2011-01-09.patch

:/opt/dokuwiki/lib/tpl/arctic# patch -p 1 < /root/arctic-tpl_functions_2011-01-09.patch
patching file tpl_functions.php
:/opt/dokuwiki/lib/tpl/arctic# cd ..

• appliquer le patch suivant pour modifier le youarehere en titre de la page : youarehere_2010-11-07.patch

:/opt/dokuwiki/inc# patch -p 1 < /root/youarehere_2010-11-07.patch
patching file template.php
:/opt/dokuwiki/inc#

D'autres paramètres sont définis ici : options