[TUTO] Hébergez votre propre wiki : "DokuWiki".
Vous aimeriez avoir sous la main un compendium, ou tout simplement, un pense-bête léger et pratique ? Alors "Follow the white rabbit..."
Nous allons mettre en place dans ce tutoriel un wiki nommé "
DokuWiki", accessible par un sous-domaine. A la fois léger et configurable, il est très utilisé par de nombreux sites internet, notamment doc.ubuntu-fr.org pour ne citer que celui-ci.
DokuWiki est un wiki Open Source simple à utiliser et très polyvalent qui n'exige aucune base de données. Ses utilisateurs l'aiment pour sa syntaxe propre et lisible. Sa facilité de maintenance, de sauvegarde et d'intégration, en font l'un des favoris des administrateurs. Le contrôle d'accès et les connecteurs d'authentification intégrés rendent DokuWiki particulièrement utile dans le contexte de l'entreprise et le grand nombre de greffons réalisés par sa communauté dynamique offre un large éventail de cas d'utilisations, bien au-delà d'un wiki traditionnel.
Vous trouverez des compléments d'information sur le
site officiel ainsi qu'une documentation étoffée pour paramétrer votre wiki selon votre convenance.
Nous partons du principe que votre installation répond aux pré-requis suivants :
- Nginx
- Php
1°) Mise à jour du système :
apt-get update && apt-get dist-upgrade
2°) Installation de DokuWiki :
cd /tmp
wget http://download.dokuwiki.org/out/dokuwiki-d9556fbc2c1c07a0baaf81c07d4165f6.tgz
tar xvf dokuwiki-d9556fbc2c1c07a0baaf81c07d4165f6.tgz
3°) Affectation des droits :
mv dokuwiki /var/www
chown -R www-data:www-data dokuwiki
chmod -R 755 dokuwiki
4°) Configuration du vhost Nginx en sous-domaine avec certificat SSL (à adapter selon vos besoins) :
nano /etc/nginx/sites-enable/dokuwiki.conf
server{
listen 80;
server_name dokuwiki.mondomain.tld;
return 301 https://$server_name$request_uri;
}
server {
listen 443 ssl;
server_name dokuwiki.mondomain.tld;
charset utf-8;
client_max_body_size 4M;
client_body_buffer_size 128k;
ssl on;
ssl_certificate /etc/nginx/keys/dokuwiki.mondomain.tld.crt-unified;
ssl_certificate_key /etc/nginx/keys/dokuwiki.mondomain.tld.key;
root /var/www/dokuwiki;
index doku.php;
location ~ /(data/|conf/|bin/|inc/|install.php) { deny all; }
location ~* \.(js|css|png|jpg|jpeg|gif|ico)$ {
expires 31536000s;
add_header Pragma "public";
add_header Cache-Control "max-age=31536000, public, must-revalidate, proxy-revalidate";
log_not_found off;
}
location / { try_files $uri $uri/ @dokuwiki; }
location @dokuwiki {
rewrite ^/_media/(.*) /lib/exe/fetch.php?media=$1 last;
rewrite ^/_detail/(.*) /lib/exe/detail.php?media=$1 last;
rewrite ^/_export/([^/]+)/(.*) /doku.php?do=export_$1&id=$2 last;
rewrite ^/(.*) /doku.php?id=$1&$args last;
}
location ~* \.php$ {
include /etc/nginx/fastcgi_params;
fastcgi_pass unix:/var/run/php5-fpm.sock;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}
}
IMPORTANT : Lors de la première installation, pensez à dérenseigner "install.php" dans la ligne :
location ~ /(data/|conf/|bin/|inc/|install.php) { deny all; }
Une fois finalisée, remettez cette directive comme sur la citation ci-dessus.
Enregistrez votre vhost et redémarrez Nginx :
service nginx restart
5°) Configuration de DokuWiki :
Il ne vous reste plus qu'à vous rendre à l'adresse de votre sous-domaine :
Et suivre les instructions...
Par la suite, prenez un peu de temps pour bien appréhender la syntaxe et toutes les possibilités offertes; Consultez la documentation officielle, elle se révèle précieuse. Vous pourrez bien évidemment y ajouter divers thèmes et plugins pour obtenir un Wiki vous correspondant.
Si vous avez des questions, des suggestions, n'hésitez pas à m'en faire part sur le
sujet de discussion.
