Description de l'installation et de la configuration de ce Wiki.

Les principaux avantages de dokuwiki sont :

• une installation simple pour avoir un wiki fonctionnel
• le support de plugins permettant d'augmenter les fonctionnalités
• le support de template permettant la personnalisation complète de l'interface
• l'ensemble des données sont stockées en fichiers texte permettant leur accès même en cas de problème du serveur web.

Pour choisir le wiki qui vous convient, allez faire un tour sur http://www.wikimatrix.org.

Cette page décrit l'installation et la personnalisation de DokuWiki, de nombreuses parties sont optionnelles ou réalisables ultérieurement.

Voir Installation de Dokuwiki

Voir Sécurité dans Dokuwiki

Je vous conseille les plugins suivants :

• translation pour permettre d'avoir des pages en plusieurs langues
• editx pour faciliter le déplacement d'une page
• edittable pour l'édition de tableaux wysiwyg

Url : http://wiki.splitbrain.org/plugin:translation

Pour l'installer, copier le lien de téléchargement et le copier dans le gestionnaire de plugins (section admin).
Il est ensuite possible de modifier les options du plugin dans le Configuration Manager.

Options pour www.bouthors.fr :

• plugin»translation»translations : en
• plugin»translation»translateui : oui

Pour l'afficher, il faut ensuite ajouter le code suivant dans le template :

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

Etant donné que j'utilise un template particulier, vous trouverez plus bas l'activation de translation dans ce template.
Pour plus de détails sur l'activation de translation dans le template par défaut, voir le site du plugin.

Url : http://wiki.splitbrain.org/plugin:pagemove

Pour l'installer, copier le lien de téléchargement et le copier dans le gestionnaire de plugins (section admin).

Une fois le plugin installé, une nouvelle section apparaît dans la partie “Admin” nommée “Page Move / Rename”.

Le template Arctic (utilisé sur ce site) remet en forme Dokuwiki pour notamment intégrer des menus sur les côtés.

Site officiel : http://www.dokuwiki.org/template:arctic

Les templates doivent être installés dans le sous répertoire lib/tpl :

bender:~# cd /opt/dokuwiki/lib/tpl/
bender:/opt/dokuwiki/lib/tpl# tar -zxvf /root/template-arctic-2008-05-04.tgz
arctic/README
arctic/COPYING
arctic/VERSION
...

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 : main + user + index
• tpl»arctic»left_sidebar_order : main,namespace,user,group,index

Afin d'intégrer parfaitement translation dans arctic comme sur ce site, translation a été modifié.
Patch de modification : patch_translation_arctic.patch
update 2008-12-23 : patch_translation_arctic-2008-12-23.patch

Installation du patch :

bender:/opt/dokuwiki/lib/plugins/translation# patch -p 1 < /root/patch_translation_arctic.patch
patching file style.css
patching file syntax.php
bender:/opt/dokuwiki/lib/plugins/translation#

Il faut ensuite modifier arctic avec le patch suivant : patch_arctic_translation.patch
Update 2009-03-25 : patch_arctic_translation_2009-3-25.patch

Installation du patch :

bender:/opt/dokuwiki/lib/tpl/arctic# patch -p 1 < /root/patch_arctic_translation.patch
patching file tpl_functions.php
bender:/opt/dokuwiki/lib/tpl/arctic#

• translation
  • modification du style translation à droite par défaut
  • modification du texte généré en titre H1
• arctic : ajout d'un bloc translation en haut des sidebar

J'ai réalisé d'autres modifications du template arctic en particulier le bandeau du haut, si vous souhaitez reproduire la même chose :

• version actuelle :
  • patch_arctic_bouthors_2009-03-25.patch
  • patch_youarehere.patch
• ancienne version :
  • appliquer le patch : patch_arctic_bouthors.patch
  • remplacer footer.html par celui ci : footer.html.gz

Installation du patch :

/opt/dokuwiki/lib/tpl/arctic# patch -p 1 < /root/patch_artic_bouthors.patch
patching file arctic_design.css
patching file arctic_layout.css
patching file footer.html
patching file layout.css
patching file main.php
patching file style.ini
/opt/dokuwiki/lib/tpl/arctic#

/opt/dokuwiki/inc# patch -p 1 < ../patch_youarehere.patch
patching file template.php
/opt/dokuwiki/inc#

Voir Authentification LDAP dans Dokuwiki

Ce patch permet de masquer complètement les sections inaccessibles, par défaut même si il n'est pas possible de visualiser les pages, il possible de vérifier leur existence et leur titre.

• Patch pour la version 2008-05-05: doku_hide-2008-05-05.patch
• Patch pour la version 2009-02-14: dokuwiki-2009-02-14_security.patch

wiki:/opt/wiki# patch -p 1 < /root/doku_hide.patch
patching file inc/common.php
patching file inc/parser/xhtml.php
patching file inc/parserutils.php
patching file inc/template.php
wiki:/opt/wiki#

Remarque : le contenu des pages est caché par défaut, l'affichage des liens d'une page dépend de la personne qui a déclenché la génération de la page.

Astuce : si les droits de lecture sont appliqués sur le wiki complet, alors l'utilisateur peut savoir si un répertoire existe ou non. Pour éviter cela, il suffit de n'autoriser en lecture que les répertoires autorisés.

Remarque 2 : ne pas oublier d'activer “sneaky_index” pour sécuriser l'index.

• inc/parser/xhtml.php : dans le contenu d'une page, les liens internes révèlent si la page existe à cause du style utilisé
• inc/parserutils.php : lorsque useheading est à 1, les références vers une page interdite révèlent le nom de la page (dans le titre, dans youarehere et dans le contenu des pages)
• inc/template.php : lorsque youarehere est activé, le style des éléments du chemin révèlent si ils existent
• inc/common.php : breadcrumb - n'ajoute pas la page à la liste si l'accès est interdit

Il peut être parfois nécessaire de regénérer l'index de recherche, par exemple après une migration. Pour cela il existe un outils en ligne de commande nommé indexer.php.
Pour l'utiliser il faut avoir php en ligne de commande installé (paquet php5-cli).

/opt/dokuwiki/bin# su www-data
/opt/dokuwiki/bin$ php indexer.php
Searching pages... 96 pages found.
cuisine:caramelbeurresale... done.
cuisine:crepes... done.
cuisine:start... done.
cuisine:tatin... done.
...
/opt/dokuwiki/bin$ exit
exit
/opt/dokuwiki/bin#

Le pieds de page est par défaut dans /usr/share/dokuwiki/lib/tpl/default/footer.html Vous pouvez le modifier, par exemple pour activer l'image “cc” en bas, il faut ajouter :

  <a target="_blank" href="http://creativecommons.org/licenses/by-nc-sa/2.0/" rel="license" title="Creative Commons License"><img src="<?=DOKU_TPL?>images/button-cc.gif" width="80" height="15" alt="Creative Commons License" border="0" /></a>

L'index Sitemap permet d'indexer complètement le wiki sous Google.

Pour le créer il faut :

• créer le fichier sitemap.xml.gz avec des droits d'écriture

# cd /opt/dokuwiki
/opt/dokuwiki# touch sitemap.xml.gz
/opt/dokuwiki# chown www-data sitemap.xml.gz
/opt/dokuwiki#

• activer la génération du fichier dans /etc/dokuwiki/local.php :

$conf['sitemap']     = 1;                //Create a google sitemap? How often? In days.

Le fichier http://www.bouthors.fr/wiki/sitemap.xml.gz est ensuite généré par dokuwiki.

Avec le paquet debian

• /etc/dokuwiki/apache.conf
• /etc/dokuwiki/local.php
• /usr/share/dokuwiki/lib/tpl/default/footer.html
• /var/lib/dokuwiki/

Avec une installation manuelle :

• /opt/dokuwiki

• Projet Bender
• Serveur Web (Apache)
• Linux
• http://wiki.splitbrain.org/wiki:dokuwiki
• http://wiki.splitbrain.org/wiki:sitemap