Packages DokuWiki pour Debian

DokuWiki est disponible sur le site officiel de Debian et vous pouvez l'installer a l'aide des procédures classiques comme apt-get.

News

Flux RSS depuis le site Debian :

Particularités du paquet Debian

Contrairement à une installation standard, le paquet Debian :

est (évidemment) maintenu par le mainteneur, ce qui vous autorise les mises à niveau et mises à jour de sécurité tout comme pour le reste de votre système.
dispose d'une hiérarchie spéciale, en résumé :
- /etc/dokuwiki
  Ce répertoire contient tous vos fichiers de configuration, ainsi que les configurations pour le serveur web, par exemple lighttpd ou apache
- /usr/share/dokuwiki
  Le répertoire dokuwiki principal (la racine de dokuwiki), c'est ici que pointe le serveur web.
- les données du wiki sont à /var/lib/dokuwiki/data, au lieu de /var/www/dokuwiki
- la configuration est à /etc/dokuwiki
est initialement configuré par le mainteneur, non pas par la page web d'installation
prend en charge la configuration de votre serveur web pour vous donner accès à votre wiki également
utilise des bibliothèques empaquetées à la place de celles embarquées comme Geshi ou SimplePie.
le fichier /etc/lighttpd/conf-available du paquet logiciel debian lighttpd est un lien symbolique vers /etc/dokuwiki/lighttpd.conf

Plusieurs de ces particularités viennent du système de gestion des paquets lui-même, d'autres sont là pour s'accorder avec la Charte Debian. Ceci comporte :

des avantages, comme une bonne intégration avec le système d'exploitation, une configuration initiale facilitée.
des inconvénients, comme des chemins de fichiers inhabituels et quelques bugs spécifiques.

Installation

Le package officiel Debian de DokuWiki peut etre installé avec les commandes suivantes (en root):

# apt-get update
# apt-get install dokuwiki

installation Lenny

Si vous souhaitez installer la dernière version, faites plutôt :

# aptitude install php-geshi
# cd /tmp
# wget http://http.us.debian.org/debian/pool/main/d/dokuwiki/dokuwiki_0.0.20090214b-2_all.deb
# dpkg -i dokuwiki_0.0.20090214b-2_all.deb

Pour un accès complet aux site depuis le LAN ou depuis internet, éditez le fichier /etc/apache/conf/dokuwiki.conf (ou si vous utilisez apache2 : /etc/apache2/conf.d/dokuwiki.conf) et remplacez 127.0.0.0 par All

Vous aurez vraisemblablement à redémarrer apache(2) pour que les modifications soient prises en compte :

(par sécurité) apache2ctl configtest
apache2ctl graceful

Puis pour avoir un accès au pages de configuration depuis le site (et que les modification puissent être enregistré par Dokuwiki :

# chown -R www-data /etc/dokuwiki/
# chown -R www-data /usr/share/dokuwiki/lib/

Issues

Packaging DokuWiki includes some issues to be dealt with to make the package compliant with the Debian policy.

File locations The page files are located at /usr/share/dokuwiki and the data directory in /var/lib/dokuwiki. The natural place for the configuration files under conf/ in the original source is /etc/dokuwiki. However, the user authentication database file acl.auth.php and users.auth.php can't be under /etc since they need to be writeable by the web server. For this reason they are located to /var/lib/dokuwiki/acl.

Removing buttons Due to feedback, the CC and PayPal buttons in the page footer were removed.

Questions and answers

Feel free to ask questions here:

Where does debian put the data dirs?

Under /var/lib/dokuwiki as the Debian Policy instructs.

Can you briefly list all steps necessary for multiple (separate) installations sharing the codebase?

A multisite/wikifarm solution for the Debian package is now the #2 item on the TODO list right after releasing the latest upstream version officially.