===== 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//
<code lscript>
apt update && apt upgrade -y
apt install apache2 php -y
</code>

__Installation__

  - télécharger la dernière version sur [[https://download.dokuwiki.org/|Dokuwiki]] <code>cd /tmp
wget https://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz </code>
  - décompresser l’archive <code>tar -xzvf dokuwiki-stable-tgz</code>
  - déplacer le dossier décompressé dans l'arborescence des pages web sous un nom simplifié : <code>mv dokuwiki-<date> /var/www/html/dokuwiki/</code>
  - attribuer les droits d'écriture sur le dossier pour le compte www-data (où un compte qui exécute le serveur Web) <code> chown -R www-data /var/www/html</code>  <wrap right round important 30%>
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//**</wrap>
  - 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//){{ :wiki:bookcreator.png?nolink&400|}}
  - é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