DokuWiki 1 : installer un wiki

A côté d’un blog WordPress utile pour créer une belle “vitrine” composée essentiellement de pages statiques et d’articles pouvant être commentés, il est intéressant de proposer des pages d’informations dont le contenu est susceptible de s’enrichir régulièrement (modifications et ajouts de pages, de “répertoires”.

Quoi de plus normal aussi que de partager en lecture certains documents avec des personnes ou des groupes de personnes de manière contrôlée, limitée, ou de les partager dans un but collaboratif avec des permissions supplémentaires d’écriture.

Si à cela vous ajoutez les souhaits d’une présentation uniforme, d’un langage de formatage simplifié mais puissant, la nécessité de conserver les versions successives d’un travail, alors le logiciel à installer est un wiki.

J’ai choisi comme moteur de wiki le logiciel DokuWiki, pour les raisons suivantes :

  • logiciel libre éprouvé, très suivi et tenu à jour par une communauté importante
  • langage de balise simple, éditeur avec barre d’outils
  • outil collaboratif utilisé par des sites web reconnus
  • connaissance préalable
  • aucune base de données n’est nécessaire
  • gestion des droits d’accès par utilisateurs ou groupes (ACL) très évolué
  • nombreux plugins et thèmes (templates)
  • historique des versions

 

Installation

Puisqu’il n’y a pas de base de données, l’installation est plus simple que celle de WordPress. A partir d’une fenêtre de terminal (Linux, Mac), ou d’un client ssh comme PuTTY (Windows) :

  • Identification : ssh nummat@w3.umons.ac.be (ou via les paramètres de PuTTY);
  • se placer dans le répertoire web : cd public_html
  • créer un répertoire pour le wiki : mkdir wiki
  • s’y placer : cd wiki
  • télécharger la dernière version de DokuWiki : wget http://www.splitbrain.org/_media/projects/dokuwiki/dokuwiki-2011-05-25a.tgz
  • décompresser l’archive : tar -xzvf dokuwiki-2011-05-25a.tgz --strip-components=1
  • effacer l’archive : rm dokuwiki-2011-05-25a.tgz
  • mettre tous les fichiers récursivement en accès rw pour owner et groupe (nummat) : find . -type f -exec chmod 0660 {} \;
  • mettre tous les dossiers récursivement en accès rwx pour owner (nummat) et rws pour le groupe (nummat), et en pré-attribuant ce groupe pour les futures créations de répertoires par le serveur (set guid actif) : find . -type d -exec chmod 2770 {} \;
  • on peut à présent régler la configuration de base de DokuWiki via un navigateur web, en pointant sur http://w3.umons.ac.be/perso/Villers.Didier/wiki/install.php
    • superuser : admin_name
    • pwd : pwd_de_l_admin
    • Nom, Prénom
    • email
    • statut public ou non par défaut du wiki
    • type de licence

Une fois tout cela accompli, le wiki est pré-configuré et (presque) opérationnel !