Ceci est une ancienne révision du document !


Installation de Dokuwiki

Cette page décrit l'installation de DokuWiki (version 2010-11-07).

Pré requis

Pour fonctionner Dokuwiki nécessite Apache et PHP. Pour ma part j'utilise les packages Debian :

  • Apache2
  • PHP5

Pour plus d'information voir l'installation d'un Serveur Web (Apache)

Installation du site

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.

A partir de Debian

Installer le paquet :

  • Dokuwiki

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. Il est accessible dans le sous répertoire /dokuwiki par défaut (si vous accéder à dokuwiki à distance, il faut configurer apache comme indiqué plus bas).

Dokuwiki est cependant fortement personnalisable, nous allons décrire quelques options pratiques. Pour info, il est conseillé d'utiliser le fichier /etc/dokuwiki/local.php pour modifier les options propres au serveur. Ce fichier n'existe pas par défaut.

Dans l'installation Debian, les répertoires utilisés sont :

  • /etc/dokuwiki : configurations
  • /usr/share/dokuwiki : binaires
  • /var/lib/dokuwiki : données et ACL

Configurer Apache

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.

A partir des sources

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/ :

bender:/opt# tar -zxvf /root/dokuwiki-2008-05-05.tgz
dokuwiki-2008-05-05/
dokuwiki-2008-05-05/.htaccess.dist
dokuwiki-2008-05-05/README
dokuwiki-2008-05-05/index.php
dokuwiki-2008-05-05/install.php
dokuwiki-2008-05-05/COPYING
dokuwiki-2008-05-05/doku.php
dokuwiki-2008-05-05/VERSION
dokuwiki-2008-05-05/bin/
dokuwiki-2008-05-05/bin/.htaccess
dokuwiki-2008-05-05/bin/indexer.php
....
bender:/opt# mv dokuwiki-2008-05-05/ dokuwiki
bender:/opt# l
total 4
drwxr-xr-x 7 matthieu Debian-exim 4096 2008-05-05 19:10 dokuwiki
bender:/opt#

Il faut ensuite modifier les droits de la façon suivante :

  • l'ensemble des fichiers peut appartenir à l'utilisateur de votre choix, mais accessible par www-data
  • le répertoire “data” et ses sous répertoires doit être modifiable par www-data
  • le répertoire “conf” doit être modifiable par www-data si vous souhaitez modifier la configuration avec l'interface web
  • le répertoire “lib/plugins/” doit être modifiable par www-data si vous souhaitez installer des plugins avec l'interface web

Exemple :

:/opt# chown -R matthieu:matthieu dokuwiki/
:/opt# chown matthieu: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 92
drwxr-xr-x  2 matthieu matthieu  4096  7 nov.  17:43 bin
drwxr-xr-x  2 www-data matthieu  4096  7 nov.  17:43 conf
-rw-r--r--  1 matthieu matthieu 17992  7 nov.  17:43 COPYING
drwxr-xr-x 10 www-data matthieu  4096  7 nov.  17:43 data
-rw-r--r--  1 matthieu matthieu  2185  7 nov.  17:43 doku.php
-rw-r--r--  1 matthieu matthieu 11730  7 nov.  17:43 feed.php
-rw-r--r--  1 matthieu matthieu  1526  7 nov.  17:43 .htaccess.dist
drwxr-xr-x  6 matthieu matthieu  4096  7 nov.  17:43 inc
-rw-r--r--  1 matthieu matthieu   182  7 nov.  17:43 index.php
-rw-r--r--  1 matthieu matthieu 17428  7 nov.  17:43 install.php
drwxr-xr-x  9 matthieu matthieu  4096  7 nov.  17:43 lib
-rw-r--r--  1 matthieu matthieu   306  7 nov.  17:43 README
-rw-r--r--  1 matthieu matthieu    22  7 nov.  17:43 VERSION
:/opt/dokuwiki# l lib/
total 32
drwxr-xr-x 2 matthieu matthieu 4096  7 nov.  17:43 exe
drwxr-xr-x 2 matthieu matthieu 4096  7 nov.  17:43 _fla
drwxr-xr-x 8 matthieu matthieu 4096  7 nov.  17:43 images
-rw-r--r-- 1 matthieu matthieu  376  7 nov.  17:43 index.html
drwxr-xr-x 9 www-data matthieu 4096  7 nov.  17:43 plugins
drwxr-xr-x 2 matthieu matthieu 4096  7 nov.  17:43 scripts
drwxr-xr-x 2 matthieu matthieu 4096  7 nov.  17:43 styles
drwxr-xr-x 3 matthieu matthieu 4096  7 nov.  17:43 tpl
:/opt/dokuwiki# l ..
total 12
drwxr-x--- 7 matthieu www-data 4096  7 nov.  17:43 dokuwiki
:/opt/dokuwiki#

Configurer Apache

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 :

bender:/etc/apache2/sites-available# vi dokuwiki
bender:/etc/apache2/sites-available# a2ensite dokuwiki
Site dokuwiki installed; run /etc/init.d/apache2 reload to enable.
bender:/etc/apache2/sites-available# /etc/init.d/apache2 reload
Reloading web server config...7058
.
bender:/etc/apache2/sites-available#

Dokuwiki doit alors être accessible sur le sous répertoire /wiki du serveur web.

Première configuration du wiki

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 :

  • le nom du site
  • le nom du super admin
  • le type de wiki
    • Open Wiki (read, write, upload for everyone)
    • Public Wiki (read for everyone, write & upload for registered users)
    • Closed Wiki (read, write, upload for registered users only)
  • la license du contenu

www.bouthors.fr est un “Public Wiki”.

Options

Une fois logué en admin, vous pouvez modifier les options dans “Admin » Configuration Manager”

Voici quelques options utilisée pour ce site :

  • lang : Fr
  • breadcrumbs : 5 (10 par défaut)
  • youarehere : oui pour faciliter la navigation
  • useheading : “toujours” pour utiliser le titre 1 de la fiche comme titre de la page
  • disableactions : “S'enregistrer”
  • sneaky_index : coché

Exemple de configuration générée

<?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
linux/dokuwiki/install.1294263250.txt.gz · Dernière modification: 2011/01/05 22:34 par matthieu
Recent changes RSS feed Debian Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki