Présentation
Dokuwiki est un wiki permettant la collaboration en ligne en créant des documents facilement éditables. Dokuwiki est fait avec le langage PHP. Il contient une interface d’édition en ligne, mais peut aussi s’éditer via des fichiers textes.
Configuration pour le serveur web Nginx
server{
server_name MONSERVEUR.tld;
index index.html index.php doku.php;
#make sure a global root is defined here
root /srv/web/dokuwiki; #adapt please
location ~ ^/(data|conf|bin|inc)/ { # secure DokuWiki
deny all;
}
location ~ ^/.*<br/>.php$ {
root /srv/web/dokuwiki; #adapt if needed
include /etc/nginx/fastcgi_params;
fastcgi_pass unix:/tmp/php5-fpm.sock;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_param PATH_INFO $uri; #necessary for URL rewrite
}
# serve static files
location ~ ^/lib/ {
root /srv/web/dokuwiki; #adapt if needed
expires 30d;
}
location / {
try_files $uri $uri/ @wiki;
}
location ~ ^/conf/ { deny all; }
location ~ ^/data/ { deny all; }
location ~ /<br/>.ht { deny all; }
location @wiki {
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 ^/tag/(.*) /doku.php?id=tag:$1&do=showtag&tag=tag:$1 last;
rewrite ^/(.*) /doku.php?id=$1&$args last;
}
}
Penser à remplacer :
- /srv/web/dokuwiki par l’adresse exacte d’accès à votre dokuwiki
- MONSERVEUR.tld par l’adresse de votre site web
- Ceci fonctionne avec php5-fpm
- Pensez à aller dans la configuration de Dokuwiki pour enlever la réécriture d’URL par le .htaccess.
- Pour php5-fpm, il faut penser à éditer le fichier /etc/php5/fpm/pool.d/www.conf et changer la ligne indiquant listen = par
;listen = 127.0.0.1:9000
listen = /tmp/php5-fpm.sock
Mise à jour de multiples installations de Dokuwiki
Dokuwiki est un bon moteur de wiki. Et même s’il ne vous convient pas, pour d’autres c’est d’une valeur ajoutée sans précédent. Ils en installent à tout va !
Le problème, quand on a plusieurs installations, ce sont les mises à jour. Ce n’est pas très long de mettre à jour, mais répéter les mêmes actions plusieurs fois est barbant.
Voilà pourquoi j’ai pensé à chercher une méthode pour mettre à jour Dokuwiki. En voici le résultat.
Le script de mise à jour de multiples installations de Dokuwiki est disponible sur Github.
Pour l’utiliser :
- téléchargez le script
- ajouter les droits d’exécution dessus avec chmod +x upgrade_dokuwiki.sh
- éditez le fichier et modifier la ligne suivante :
installations="/srv/web/domain/sub/my_dokuwiki
/srv/web/domain/sub2/its_dokuwiki"
par quelque chose comme :
installations="/chemin/absolu/vers/mon/premier/wiki
/chemin/absolu/vers/mon/second/wiki"
- allez sur le site officiel. Allez sur Download, puis validez, copiez l’adresse du lien, par exemple https://download.dokuwiki.org/out/dokuwiki-5422200921b877a379e34cc4e0fee22a.tgz
- lancez le script de mise à jour avec ce lien :
bash upgrade_dokuwiki.sh https://download.dokuwiki.org/out/dokuwiki-5422200921b877a379e34cc4e0fee22a.tgz
Et le tour est joué !
Astuce : ajouter des encarts
Rien de très compliqué, il suffit d’utiliser le plugin:note :
- Cliquez de droit sur le lien suivant (ce lien est disponible sur la page officiel du module externe note , et faites copier l’adresse URL : http://gauret.free.fr/fichiers/dokuwiki/dokuwiki-note-20090615.tgz
- Allez dans l’interface administrateur de Dokuwiki en appuyant sur Admin
- Choisissez Gestion des modules externes
- Collez l’adresse précédemment utilisée dans le champ URL:
- Cliquez sur télécharger
Votre module est alors installé !
Liens utiles
- Site officiel de Dokuwiki
- Contenu additif (plugins)
- Un plugin pour ajouter des notes
- Ajouter un bouton dans l'éditeur d'articles (fr) : article francisé, vient à l’essentiel, moins complet que le lien suivant
- Ajouter un bouton dans l'éditeur d'articles (en) : article original plus complet