This is an old revision of the document!
This page describes how to customize DokuWiki through templates.
This website is based on Arctic-mbo, based on Arctic template.
This section discribes how to deploy in the simpliest way the template of this website.
Arctic-mbo is a customization of Arctic which add the left sidebar to Dokuwiki.
Original Arctic template is available here : http://www.dokuwiki.org/template:arctic
You can download Arctic-mbo here : arctic-mbo_2011-01-06.tgz
you need to install the translation plugin before adding “extra” to the left sidebar.
To install Arctic-mbo, unzip the archive to 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 ....
To enable the template, you just need to select it in the list in “Admin » Config Manager”
Once activated, new spefict parameters appear at the end of the configuration manager, select the following options :
Other parameters are defined here : options
:/opt/dokuwiki/inc# patch -p 1 < /root/youarehere_2010-11-07.patch patching file template.php :/opt/dokuwiki/inc#
:/opt/dokuwiki/lib/plugins/translation# patch -p 1 < /root/translation_2010-12-10_arctic.patch patching file style.css :/opt/dokuwiki/lib/plugins/translation#
This section describes how to install the original template Arctic and how to modify it manually.
Download arctic from here : http://www.dokuwiki.org/template:arctic
Templates need to be installed in 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 ...
To activate the template, select it in the list in “Admin » Config Manager”
Once activated, new spefict parameters appear at the end of the configuration manager.
Select the following options :
This webiste use translation plugin to translate pages.
You need to add the plugin before applying the following changes.
To add the translation options in the left sidebar, create the file lib/tpl/arctic/left_sidebar.html with the following content :
<?php $translation = &plugin_load('helper','translation'); if ($translation) echo $translation->showTranslations(); ?>
Then add “extra” inside tpl»arctic»left_sidebar_content.
To put translation at the top of the sidebar, change tpl»arctic»left_sidebar_order to extra,main,namespace,user,group,index
Finally, here is a patch to adapt the translation style to the sidebar : 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#
To get the look & feel of this website, you also need to add the following changes :
:/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#
:/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 ..
:/opt/dokuwiki/inc# patch -p 1 < /root/youarehere_2010-11-07.patch patching file template.php :/opt/dokuwiki/inc#
Some other parameters are defined here : Options