DokuWiki

Principes

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

…

Installation

Prérequis

Le serveur doit disposer des paquetages apache2 et php

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

Installation

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

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

décompresser l’archive

tar -xzvf dokuwiki-stable-tgz

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

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

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

procéder à l’installation de l'application depuis le navigateur : http://x.x.x.x/dokuwiki/install.php

définir un compte super-utilisateur si nécessaire

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

Couplage à un annuaire

Dans ‘Administrer’ / ‘Gestionnaire d’extension’ → activer le plugin pour Authad (AD Windows) ou AuthLDAP

Dans ‘Administrer’ / ‘Paramètres de configuration’ : renseigner les paramètres de connexion à l’annuaire pour le plugin

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)

Permettre l’export en PDF

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)

éventuellement, installer le plugin bookcreator, qui permet de constituer l’export que l’on souhaite

installer le plugin par le gestionnaire d’extension

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)

dans la page correspondant au paramètre « ebook », renseigner le texte « ~~BOOK~~ ». La page apparaît alors avec un menu permettant l'export