Table des matières

DokuWiki

Procédures

Installation

  1. Télécharger la dernière archive d'installation.
  2. Décompresser de fichier dokuwiki-YYYY-MM-DD.tgz obtenu.
  3. Copier les fichiers au bon emplacement.
  4. Configurer le wiki en appelant localhost[/repertoire_du_wiki]/install.php.
  5. Supprimer install.php.

La version Greebo (2018-04-22) requiert PHP 5.6+.

Installation sur Linux

  1. Donner les permissions aux répertoires de Dokuwiki au user www-data (du groupe www-data) (peut être confirmé avec phpinfo()). Voir Setting up file permissions pour les répertoires à traiter.
    • conf/ → R/W
    • data/ → R/W
    • data/tmp/ → R/W
    • lib/plugins/ → R/W
    • lib/ → R (755)
    • lib/tpl → R/W
  2. Permettre la configuration par .htaccess. Voir Web Access Security. En gros, il faut ajouter une directive sous <VirtualHost> du wiki: 
    <Directory /var/www/wiki>
    Options Indexes FollowSymLinks MultiViews
    AllowOverride all
    Order allow,deny
    allow from all
</Directory>

    L'option importante est AllowOverride all au lieu de AllowOverride none.

SSL

  1. Activier le module SSL d'Apache : 
    $ a2enmod ssl
$ sudo /etc/init.d/apache2 restart
  2. Créer le certificat .crt et la clé .key : 
    openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout wiki.key -out wiki.crt
  3. Changer le <VirtualHost *:80> à <VirtualHost *:443>: 
    SSLEngine on
SSLCertificateFile /etc/ssl/crt/wiki.crt
SSLCertificateKeyFile /etc/ssl/crt/wiki.key

Mise à jour

Une mise à jour peut être effectuée facilement avec le plugin DokuWiki Upgrade Plugin.
  1. Faire une sauvegarde du répertoire contenant le wiki.
  2. Télécharger la dernière archive d'installation.
  3. Décompresser de fichier dokuwiki-YYYY-MM-DD.tgz obtenu.
  4. Dans Terminal, exécuter la commande cp -R <repertoire_des_fichiers_decompresses>/ <repertoire_cible_wiki>, exemple cp -R dokuwiki-2013-01-01/ /var/www/wiki.
  5. Supprimer les fichiers inutiles :
    1. install.php

Plugins utilisés

Nom Utilité
indexmenu Show a customizable and sortable index for a namespace.
pagequery Search for (fulltext) and list wiki pages, sorted and optionally grouped by name, date, creator, abc, etc. in columns.
searchpattern Find a specified pattern inside wiki pages.
todo Create a checkbox based todo list with optional user assignment.
AuthLDAP This plugin allows authentication against an LDAP directory using the ACL feature.
code Enhancements for the normal <code> syntax.
googleanalytics Plugin to embed your google analytics code for your site.
imagebox Entoure les images avec un cadre de décoration.
keyboard Pour faire des raccourcis clavier. N'est plus maintenu.
mathpublish Permet de faire des formules mathématiques. Anciennement math. N'est plus maintenu, utiliser MathJax.
note Faire des notes. Peut être remplacé par WRAP ?
outdent Remove one level of indenting
wikistatistics Donne des statistiques sur le wiki, exemple, le nombre de pages.
wrap

Installation avec nginx

Ne fonctionne pas

Installer php-fpm : 

$ sudo apt install php-fpm
$ sudo systemctl status php7.2-fpm

nginx utilise aussi www-data:www-data comme user:group par son processus.

Sources