====== 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**.

  * [[http://packages.debian.org/dokuwiki|package overview]]
  * [[http://packages.qa.debian.org/d/dokuwiki.html|Overview of dokuwiki source package]]
  * [[http://bugs.debian.org/cgi-bin/pkgreport.cgi?pkg=dokuwiki|Debian Bug report logs: package dokuwiki]]

===== News =====
Flux RSS depuis le site Debian :
{{rss>http://packages.qa.debian.org/d/dokuwiki/news.rss20.xml}}

===== 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 (un compte administrateur ''admin'' est créé)
  * 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 [[http://www.debian.org/doc/devel-manuals.fr.html#policy|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 [[http://www.debian.org/|Debian]] de DokuWiki peut etre installé avec les commandes suivantes (en root) : 
<file>
# apt-get update
# apt-get install dokuwiki
</file>

===== installation Lenny =====
Si vous souhaitez installer la dernière version, faites plutôt :
<file>
# aptitude install php-geshi
# cd /tmp
# wget https://download.dokuwiki.org/out/dokuwiki-c5525093cf2c4f47e2e5d2439fe13964.tgz
# tar -xvf dokuwiki-c5525093cf2c4f47e2e5d2439fe13964.tgz
</file>

Pour un accès complet au 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 aux pages de configuration depuis le site (et que les modifications puissent être enregistrées par Dokuwiki :
<file>
# chown -R www-data /etc/dokuwiki/
# chown -R www-data /usr/share/dokuwiki/
</file>

===== Issues =====

Packaging DokuWiki includes some issues to be dealt with to make the package compliant with the [[http://www.debian.org/doc/debian-policy/|Debian policy]].

  * **File locations** The page files are located at ''/usr/share/dokuwiki'' and the data directory in ''/var/lib/dokuwiki'

===== Questions and answers ======

Feel free to ask questions here:


:?: Where does debian put the data dirs?

:!: Under /var/lib/dokuwiki as the [[http://www.debian.org/doc/debian-policy/|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.