Dokuwiki est une application de type wiki fonctionnant sans base de données : l'ensemble des pages est enregistré dans des fichiers texte. Parmi les fonctionnalités offertes, on trouvera :

• Gestion des droits d'accès par comptes et groupes
• Possibilité d'inclure du code HTML et PHP,
• Colorisation syntaxique automatique pour de nombreux langages
• Extensions par divers modules :
  • Authentification LDAP
  • Export de page ou d'ensemble de pages au format PDF
  • …

Prérequis

Le serveur doit disposer des paquetages apache2 et php

apt update && apt upgrade -y
apt install apache2 php -y

Installation

1. télécharger la dernière version sur Dokuwiki

   cd /tmp
   wget https://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz 

2. décompresser l’archive

   tar -xzvf dokuwiki-stable-tgz

3. déplacer le dossier décompressé dans l'arborescence des pages web sous un nom simplifié :

   mv dokuwiki-<date> /var/www/html/dokuwiki/

4. attribuer les droits d'écriture sur le dossier pour le compte www-data (où un compte qui exécute le serveur Web)

    chown -R www-data /var/www/html

   en cas d'erreur sur un problème lié à la bibliothèque UTF8, procéder à l'installation du paquetage php-xml et relancer apache2
   apt install php-xml
   systemctl restart apache2

5. procéder à l’installation de l'application depuis le navigateur : http://x.x.x.x/dokuwiki/install.php
   1. définir un compte super-utilisateur si nécessaire
   2. activer les ACL pour gérer des droits

Gérer le menu

Un menu latéral gauche peut être ajouté en accédant au lien <urlServeurDokuwiki>/doku.php?id=sidebar

1. Dans ‘Administrer’ / ‘Gestionnaire d’extension’ → activer le plugin pour Authad (AD Windows) ou AuthLDAP
2. Dans ‘Administrer’ / ‘Paramètres de configuration’ : renseigner les paramètres de connexion à l’annuaire pour le plugin
3. Dans ‘Administrer’ / ‘Paramètres de configuration’ / ‘authentification’ : choisir l’authentification authad ou authldap à la place de authplain et indiquer le groupe ou le compte qui permettra d’administrer le site (cela modifie le fichier ../conf/local.php)

1. au minimum, installer le plugin dw2pdf (à télécharger, décompresser et mettre dans le dossier des plugins) : une icône avec un cercle creux apparaît dans le menu latéral des pages (exporter en PDF)
2. éventuellement, installer le plugin bookcreator, qui permet de constituer l’export que l’on souhaite
   1. installer le plugin par le gestionnaire d’extension
   2. paramétrer le plugin avec les valeurs choisies (fonctionne avec les paramètres par défaut). Une icône avec un logo proche d’Adobe apparaît dans le menu latéral des pages (Ajouter/retirer du livre)
   3. dans la page correspondant au paramètre « ebook », renseigner le texte « ~~BOOK~~ ». La page apparaît alors avec un menu permettant l'export