Ceci est une ancienne révision du document !
Cette page décrit l'installation de DokuWiki.
Mis à jour pour la version 2011-05-25a “Rincewind”
Pour fonctionner Dokuwiki nécessite Apache et PHP. Pour ma part j'utilise les packages Debian :
Pour plus d'information voir l'installation d'un Serveur Web (Apache)
DokuWiki peut ensuite être installé à partir du repository Debian ou à partir des sources.
J'ai une préférence pour l'installation manuelle afin de ne pas risquer un upgrade automatique de Debian.
Installer le paquet :
Lors de l'installation, choisissez le sous répertoire du site web à utiliser, par exemple ce site utilise /wiki.
La configuration par défaut fournit déjà un wiki parfaitement fonctionnel (si vous accéder à dokuwiki à distance, il faut configurer apache comme indiqué plus bas).
Dans l'installation Debian, les répertoires utilisés sont :
Par défaut, avec apache2, dokuwiki est configuré par le fichier /etc/dokuwiki/apache.conf. Il est autorisé par défaut uniquement pour 127.0.0.1.
Pour le rendre accessible à tous, il faut modifier “allow from” :
Alias /dokuwiki /usr/share/dokuwiki <Directory /usr/share/dokuwiki/> Options +FollowSymLinks AllowOverride All order allow,deny # allow from 127.0.0.1 allow from all </Directory>
Puis redémarrer Apache pour appliquer les changements.
L'installation à partir des sources n'est pas beaucoup plus compliquée, elle permet d'obtenir les dernières fonctionnalités.
Les sources sont téléchargeables à l'adresse http://www.splitbrain.org/projects/dokuwiki
Installer les sources dans le répertoire de votre choix, par exemple /opt/dokuwiki/ :
:/opt# tar -zxvf /root/dokuwiki-2012-01-25a.tgz dokuwiki-2012-01-25a/ dokuwiki-2012-01-25a/lib/ dokuwiki-2012-01-25a/lib/styles/ dokuwiki-2012-01-25a/lib/styles/screen.css dokuwiki-2012-01-25a/lib/styles/all.css dokuwiki-2012-01-25a/lib/styles/print.css dokuwiki-2012-01-25a/lib/styles/index.html dokuwiki-2012-01-25a/lib/styles/feed.css dokuwiki-2012-01-25a/lib/plugins/ ... :/opt# l total 4 drwxr-xr-x 7 matt matt 4096 19 avril 12:17 dokuwiki-2012-01-25a :/opt# mv dokuwiki-2012-01-25a/ dokuwiki :/opt# l total 4 drwxr-xr-x 7 matt matt 4096 19 avril 12:17 dokuwiki :/opt#
Il faut ensuite modifier les droits de la façon suivante :
Exemple :
:/opt# chown -R matt:matt dokuwiki/ :/opt# chown matt:www-data dokuwiki/ :/opt# chmod 750 dokuwiki/ :/opt# cd dokuwiki/ :/opt/dokuwiki# chown -R www-data data/ :/opt/dokuwiki# chown www-data conf/ :/opt/dokuwiki# chown www-data lib/plugins/ :/opt/dokuwiki# l total 100 drwxr-xr-x 2 matt matt 4096 19 avril 12:09 bin drwxr-xr-x 2 www-data matt 4096 19 avril 12:09 conf -rw-r--r-- 1 matt matt 18092 19 avril 12:09 COPYING drwxr-xr-x 12 www-data matt 4096 19 avril 12:09 data -rw-r--r-- 1 matt matt 2290 19 avril 12:12 doku.php -rw-r--r-- 1 matt matt 17037 19 avril 12:09 feed.php -rw-r--r-- 1 matt matt 1526 19 avril 11:36 .htaccess.dist drwxr-xr-x 6 matt matt 4096 19 avril 12:12 inc -rw-r--r-- 1 matt matt 182 19 avril 11:36 index.php -rw-r--r-- 1 matt matt 17781 19 avril 12:09 install.php drwxr-xr-x 8 matt matt 4096 19 avril 12:09 lib -rw-r--r-- 1 matt matt 306 19 avril 12:09 README -rw-r--r-- 1 matt matt 20 19 avril 12:12 VERSION :/opt/dokuwiki# l lib total 28 drwxr-xr-x 2 matt matt 4096 19 avril 12:09 exe drwxr-xr-x 8 matt matt 4096 19 avril 12:09 images -rw-r--r-- 1 matt matt 376 19 avril 11:36 index.html drwxr-xr-x 10 www-data matt 4096 19 avril 12:02 plugins drwxr-xr-x 3 matt matt 4096 19 avril 12:09 scripts drwxr-xr-x 2 matt matt 4096 19 avril 12:09 styles drwxr-xr-x 3 matt matt 4096 19 avril 12:09 tpl :/opt/dokuwiki# l .. total 4 drwxr-x--- 7 matt www-data 4096 19 avril 12:17 dokuwiki :/opt/dokuwiki#
Lorsqu'on installe dokuwiki à partir des sources, il est nécessaire de réaliser la configuration d'Apache manuellement.
Par exemple, en créant le fichier /etc/apache2/sites-available/dokuwiki suivant :
Alias /wiki /opt/dokuwiki <Directory /opt/dokuwiki/> Options +FollowSymLinks AllowOverride All order allow,deny allow from all </Directory>
Puis en l'activant :
:/etc/apache2/sites-available# vi dokuwiki :/etc/apache2/sites-available# a2ensite dokuwiki Site dokuwiki installed; run /etc/init.d/apache2 reload to enable. :/etc/apache2/sites-available# /etc/init.d/apache2 reload Reloading web server config...7058 . :/etc/apache2/sites-available#
Dokuwiki doit alors être accessible sur le sous répertoire /wiki du serveur web.
Par défaut DokuWiki est un wiki open permettant à quiconque de modifier les pages sans authentification.
Pour faire la première configuration (nom du site, droits d'accès…), il existe une page d'installation : install.php dans la racine du site.
Par exemple http://www.monsite.fr/wiki/install.php.
Il faut que le répertoire de configuration soit accessible en écriture par www-data. (il est possible de supprimer les droits d'écriture après)
Les options sont :
www.bouthors.fr est un “Public Wiki”.
Une fois logué en admin, vous pouvez modifier les options dans “Admin » Configuration Manager”
Voici quelques options utilisée pour ce site :
<?php /* * Dokuwiki's Main Configuration File - Local Settings * Auto-generated by config plugin * Run for user: matthieu * Date: Sun, 02 Jan 2011 23:14:53 +0100 */ $conf['title'] = 'www.bouthors.fr'; $conf['lang'] = 'fr'; $conf['license'] = 'cc-by-sa'; $conf['breadcrumbs'] = 5; $conf['youarehere'] = 1; $conf['useheading'] = '1'; $conf['useacl'] = 1; $conf['superuser'] = '@admin'; $conf['disableactions'] = 'register'; $conf['sneaky_index'] = 1; // end auto-generated content