Cette page vous donne les différences entre la révision choisie et la version actuelle de la page.
linux:dokuwiki:install [2011/01/05 20:45] matthieu créée |
linux:dokuwiki:install [2012/06/17 20:12] (Version actuelle) matthieu [Exemple de configuration générée] |
||
---|---|---|---|
Ligne 1: | Ligne 1: | ||
- | ===== Installation de Dokuwiki ===== | + | {{tag>fr fr:linux fr:serveur fr:web fr:wiki}} |
- | ==== Pré requis ==== | + | ====== 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 fonctionner Dokuwiki nécessite Apache et PHP. | ||
Ligne 7: | Ligne 11: | ||
* PHP5 | * PHP5 | ||
- | Pour plus d'information voir l'installation d'un [[Serveur Web]] | + | Pour plus d'information voir l'installation d'un [[linux:Serveur Web]] |
- | ==== Installation du site ==== | + | ===== Installation du site ===== |
DokuWiki peut ensuite être installé à partir du repository Debian ou à partir des sources.\\ | 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. | J'ai une préférence pour l'installation manuelle afin de ne pas risquer un upgrade automatique de Debian. | ||
- | === A partir de Debian === | + | ==== A partir de Debian ==== |
Installer le paquet : | Installer le paquet : | ||
* Dokuwiki | * Dokuwiki | ||
Ligne 20: | Ligne 24: | ||
Lors de l'installation, choisissez le sous répertoire du site web à utiliser, par exemple ce site utilise ///wiki//. | 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). | + | 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). |
- | + | ||
- | 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 : | Dans l'installation Debian, les répertoires utilisés sont : | ||
Ligne 30: | Ligne 32: | ||
- | == Configurer Apache == | + | === 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. | 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" : | Pour le rendre accessible à tous, il faut modifier "allow from" : | ||
- | <file> | + | <file apache> |
Alias /dokuwiki /usr/share/dokuwiki | Alias /dokuwiki /usr/share/dokuwiki | ||
<Directory /usr/share/dokuwiki/> | <Directory /usr/share/dokuwiki/> | ||
Ligne 48: | Ligne 50: | ||
- | === A partir des sources === | + | ==== 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. | L'installation à partir des sources n'est pas beaucoup plus compliquée, elle permet d'obtenir les dernières fonctionnalités. | ||
Ligne 55: | Ligne 57: | ||
Installer les sources dans le répertoire de votre choix, par exemple ///opt/dokuwiki/// : | Installer les sources dans le répertoire de votre choix, par exemple ///opt/dokuwiki/// : | ||
<code> | <code> | ||
- | bender:/opt# tar -zxvf /root/dokuwiki-2008-05-05.tgz | + | :/opt# tar -zxvf /root/dokuwiki-2012-01-25a.tgz |
- | dokuwiki-2008-05-05/ | + | dokuwiki-2012-01-25a/ |
- | dokuwiki-2008-05-05/.htaccess.dist | + | dokuwiki-2012-01-25a/lib/ |
- | dokuwiki-2008-05-05/README | + | dokuwiki-2012-01-25a/lib/styles/ |
- | dokuwiki-2008-05-05/index.php | + | dokuwiki-2012-01-25a/lib/styles/screen.css |
- | dokuwiki-2008-05-05/install.php | + | dokuwiki-2012-01-25a/lib/styles/all.css |
- | dokuwiki-2008-05-05/COPYING | + | dokuwiki-2012-01-25a/lib/styles/print.css |
- | dokuwiki-2008-05-05/doku.php | + | dokuwiki-2012-01-25a/lib/styles/index.html |
- | dokuwiki-2008-05-05/VERSION | + | dokuwiki-2012-01-25a/lib/styles/feed.css |
- | dokuwiki-2008-05-05/bin/ | + | dokuwiki-2012-01-25a/lib/plugins/ |
- | dokuwiki-2008-05-05/bin/.htaccess | + | ... |
- | dokuwiki-2008-05-05/bin/indexer.php | + | :/opt# l |
- | .... | + | |
- | bender:/opt# mv dokuwiki-2008-05-05/ dokuwiki | + | |
- | bender:/opt# l | + | |
total 4 | total 4 | ||
- | drwxr-xr-x 7 matthieu Debian-exim 4096 2008-05-05 19:10 dokuwiki | + | drwxr-xr-x 7 matt matt 4096 19 avril 12:17 dokuwiki-2012-01-25a |
- | bender:/opt# | + | :/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> | </code> | ||
Ligne 83: | Ligne 86: | ||
Exemple : | Exemple : | ||
<code> | <code> | ||
- | bender:/opt# chown -R matthieu:matthieu dokuwiki/ | + | :/opt# chown -R matt:matt dokuwiki/ |
- | bender:/opt# chown matthieu:www-data dokuwiki/ | + | :/opt# chown matt:www-data dokuwiki/ |
- | bender:/opt# chmod 750 dokuwiki/ | + | :/opt# chmod 750 dokuwiki/ |
- | bender:/opt# chown -R www-data dokuwiki/data/ | + | :/opt# cd dokuwiki/ |
- | bender:/opt# chown www-data dokuwiki/conf/ | + | :/opt/dokuwiki# chown -R www-data data/ |
- | bender:/opt# chown www-data dokuwiki/lib/plugins/ | + | :/opt/dokuwiki# chown www-data conf/ |
- | bender:/opt# chown matthieu:www-data dokuwiki/ | + | :/opt/dokuwiki# chown www-data lib/plugins/ |
- | bender:/opt# l | + | :/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 | total 4 | ||
- | drwxr-x--- 7 matthieu www-data 4096 2008-05-05 19:10 dokuwiki | + | drwxr-x--- 7 matt www-data 4096 19 avril 12:17 dokuwiki |
- | bender:/opt# l dokuwiki/ | + | :/opt/dokuwiki# |
- | total 88 | + | |
- | drwxr-xr-x 2 matthieu matthieu 4096 2008-05-05 19:10 bin | + | |
- | drwxr-xr-x 2 www-data matthieu 4096 2008-05-05 19:10 conf | + | |
- | -rw-r--r-- 1 matthieu matthieu 17992 2008-05-05 19:10 COPYING | + | |
- | drwxr-xr-x 10 www-data matthieu 4096 2008-05-05 19:10 data | + | |
- | -rw-r--r-- 1 matthieu matthieu 2080 2008-05-05 19:10 doku.php | + | |
- | -rw-r--r-- 1 matthieu matthieu 10624 2008-05-05 19:10 feed.php | + | |
- | -rw-r--r-- 1 matthieu matthieu 1470 2008-05-05 19:10 .htaccess.dist | + | |
- | drwxr-xr-x 6 matthieu matthieu 4096 2008-05-05 19:10 inc | + | |
- | -rw-r--r-- 1 matthieu matthieu 185 2008-05-05 19:10 index.php | + | |
- | -rw-r--r-- 1 matthieu matthieu 16038 2008-05-05 19:10 install.php | + | |
- | drwxr-xr-x 8 matthieu matthieu 4096 2008-05-05 19:10 lib | + | |
- | -rw-r--r-- 1 matthieu matthieu 264 2008-05-05 19:10 README | + | |
- | -rw-r--r-- 1 matthieu matthieu 11 2008-05-05 19:10 VERSION | + | |
- | bender:/opt# l dokuwiki/lib/ | + | |
- | total 24 | + | |
- | drwxr-xr-x 2 matthieu matthieu 4096 2008-05-05 19:10 exe | + | |
- | drwxr-xr-x 6 matthieu matthieu 4096 2008-05-05 19:10 images | + | |
- | drwxr-xr-x 11 www-data matthieu 4096 2008-05-05 19:10 plugins | + | |
- | drwxr-xr-x 2 matthieu matthieu 4096 2008-05-05 19:10 scripts | + | |
- | drwxr-xr-x 2 matthieu matthieu 4096 2008-05-05 19:10 styles | + | |
- | drwxr-xr-x 3 matthieu matthieu 4096 2008-05-05 19:10 tpl | + | |
- | bender:/opt# | + | |
</code> | </code> | ||
- | == Configurer Apache == | + | === Configurer Apache === |
Lorsqu'on installe dokuwiki à partir des sources, il est nécessaire de réaliser la configuration d'Apache manuellement. | 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 : | Par exemple, en créant le fichier ///etc/apache2/sites-available/dokuwiki// suivant : | ||
- | <file> | + | <file apache> |
Alias /wiki /opt/dokuwiki | Alias /wiki /opt/dokuwiki | ||
<Directory /opt/dokuwiki/> | <Directory /opt/dokuwiki/> | ||
Ligne 135: | Ligne 139: | ||
Puis en l'activant : | Puis en l'activant : | ||
<code> | <code> | ||
- | bender:/etc/apache2/sites-available# vi dokuwiki | + | :/etc/apache2/sites-available# vi dokuwiki |
- | bender:/etc/apache2/sites-available# a2ensite dokuwiki | + | :/etc/apache2/sites-available# a2ensite dokuwiki |
Site dokuwiki installed; run /etc/init.d/apache2 reload to enable. | Site dokuwiki installed; run /etc/init.d/apache2 reload to enable. | ||
- | bender:/etc/apache2/sites-available# /etc/init.d/apache2 reload | + | :/etc/apache2/sites-available# /etc/init.d/apache2 reload |
Reloading web server config...7058 | Reloading web server config...7058 | ||
. | . | ||
- | bender:/etc/apache2/sites-available# | + | :/etc/apache2/sites-available# |
</code> | </code> | ||
Dokuwiki doit alors être accessible sur le sous répertoire /wiki du serveur web. | Dokuwiki doit alors être accessible sur le sous répertoire /wiki du serveur web. | ||
- | ===== Première configuration du wiki ===== | + | ====== Première configuration du wiki ====== |
Par défaut DokuWiki est un wiki open permettant à quiconque de modifier les pages sans authentification. | Par défaut DokuWiki est un wiki open permettant à quiconque de modifier les pages sans authentification. | ||
Ligne 164: | Ligne 168: | ||
www.bouthors.fr est un "Public Wiki". | 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> | ||