Dokuwiki est un moteur de wiki sur lequel tourne ce site. Il est libre et a la particularité de ne pas se reposer sur une BDD de type MySQL ou PgSQL : il enregistre ses informations dans des fichiers. Ainsi il est facile de migrer le Wiki d'une machine à l'autre, avec un simple copier/coller.

Dokuwiki est doté d'une multitude de plugins afin d'ajouter des fonctionnalités au concept de base ; voici ceux que j'utilise :

• cloud : permet d'afficher les mots les plus utilisés sous forme de nuage (similaire aux nuages de tags que l'on connait)
• discussion : permet d'ajouter un espace de commentaires sur chaque page, à l'instar des moteurs de blogs
• note : permet de créer des notes (Note/Important/Tip/Warning) dans des cadres
• pagelist : affiche un index des pages contenues dans un espace de nom (càd un répertoire)
• pagemove : outil pour facilement déplacer une page d'un répertoire à un autre
• searchindex permet de créer et mettre à jour un index de mots-clé pour faire des recherches plus rapide sur le wiki. NB : avec dokuwiki 2011-05-25a (le packet d'Ubuntu 12.04) ce plugin cause des erreurs javascript faisant disparaitre la toolbar d'édition de page.
• tag permet d'implémenter des tags pour “catégoriser” les pages

Comme dit plus haut, il est très simple de sauver un wiki ; pour cela il faut sauvegarder les dossiers suivants (valable avec Debian et Ubuntu) :

• /etc/dokuwiki qui contient le configuration
• /usr/share/dokuwiki : racine (pour le serveur web)
• /var/lib/dokuwiki : qui contient toutes les données du wiki (les pages, l'historique des changements et les images)

On peut sauvegarder tout cela très facilement avec un :

tar cjvf dokuwiki_`date +%Y-%m-%d`.tar.bz2 /etc/dokuwiki /usr/share/dokuwiki /var/lib/dokuwiki

Pour faire simple, il suffit de restaurer le zip de la sauvegarde ; mais dans la pratique il faut faire attention à ces aspects (attention les chemins sont ceux d'une distribution Debian/Ubuntu) :

• dans /var/lib/dokuwiki/data, restaurer :
  • les pages (pages)
  • les modifications (attic et meta)
  • les images (media)
• modifier /etc/dokuwiki/apache.conf (“Allow from all”)
• compléter le fichier /etc/dokuwiki/local.php (personnalisation de dokuwiki)
• récupérer les utilisateurs du précédent wiki : fichier /etc/dokuwiki/users.auth.php
• régler les problèmes de droits : cf https://www.dokuwiki.org/install:permissions

J'ai retenu cela :

chown www-data /var/lib/dokuwiki/data
chown www-data /var/lib/dokuwiki/lib/plugins

J'ajouterai qu'avec le package Ubuntu actuel (Version : 0.0.20110525a-2) il faut aussi passer ces commandes :

# les fichiers de conf doivent être writable par la webUI
chown www-data /etc/dokuwiki
chown www-data /etc/dokuwiki/local.php

Et dans mon cas je dois modifier l'alias :

vi /etc/apache2/conf.d/dokuwiki.conf
 Alias      /dw                          /usr/share/dokuwiki/

• via l'interface web :
  • réinstaller les plugins : sidebar, note, cloud (pas searchindex car il fait disparaitre la toolbar d'édition de page)
  • faire une passe sur la configuration au cas ou (Admin/configuration en webUI)

Le plugin tag pose un problème de présentation avec le thème sidebar, car il ne positionne pas le “floating” avec les menus de droite (l'index des grands titres). Pour résoudre ce problème, il faut modifier la feuille de style CSS. Si on utilise le paquet ubuntu, le plus simple est de surcharger les styles dans le fichier idoine : /etc/dokuwiki/userstyle.css

vi /etc/dokuwiki/userstyle.css
/* Place customisations to screen mode style sheet here */
div.dokuwiki div.tags {
  border-top: 2px dotted #8cacbb;
  font-size: 95%;
/*  text-align: right;*/
/*  clear: both;*/
  text-align: left;
  clear: none;
}

• voir https://www.dokuwiki.org/faq:toolbar