{{tag>fr fr:linux fr:serveur fr:web fr:wiki}}
====== Installation de Dokuwiki ======
Cette page décrit l'installation de [[linux:dokuwiki]].

:!: Mis à jour pour la version 2011-05-25a “Rincewind”
===== 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 [[linux:Serveur Web]]

===== 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 (si vous accéder à dokuwiki à distance, il faut configurer apache comme indiqué plus bas).

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" :
<file apache>
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>
</file>

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

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

=== 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 :
<file apache>
Alias /wiki         /opt/dokuwiki
<Directory /opt/dokuwiki/>
        Options +FollowSymLinks
        AllowOverride All
        order allow,deny
        allow from all
</Directory>
</file>

Puis en l'activant :
<code>
:/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#
</code>

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 =====
<file php>
<?php
/*
 * Dokuwiki's Main Configuration File - Local Settings
 * Auto-generated by config plugin
 * Run for user: matthieu
 * Date: Sun, 17 Jun 2012 20:07:40 +0200
 */

$conf['title'] = 'Bouthors.fr';
$conf['lang'] = 'fr';
$conf['template'] = 'arctic-mbo';
$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;
$conf['subscribers'] = 1;
$conf['cachetime'] = -1;
$conf['sitemap'] = 1;

// end auto-generated content

</file>