La dernière version stable de debian est codée etch. Si vous utilisez une version plus ancienne, pensez à Upgrader.
apt-get install dokuwiki latex-extra le package latex est nécessaire pour les fonctions d'affichage de formules mathématiques.
autre solution : aptitude install dokuwiki latex-extra

Le package Debian vous pose alors trois questions :

• Où se situe la racine du dossier Dokuwiki ? (par défaut ”/dokuwiki”, ou donnez une adresse du style :http://localhost/dokuwiki)
• Qui a le droit de surfer sur Dokuwiki (par défaut, seulement vous, je conseille l'option 3 : tout le monde) ?
• Doit on purger les pages lors d'une déinstallation ? (ce qui signifie qu'une commande apt-get –purge remove dokuwiki va effacer toutes les pages Dokuwiki crées) ?

The debian package organizes the installation software in the following paths

1. /var/lib/dokuwiki
2. /usr/share/dokuwiki
3. /etc/dokuwiki
4. /etc/apache(2)

En 1) vous trouvez les dossiers acl and data. Le dossier acl est utliser pour stocker les paramètres de configuration, le dossier data est utiliser pour y stocker les pages.

En 2) le moteur de dokuwiki mais sans le dossier conf(iguration) qui est un lien symbolique vers /etc/dokuwiki et data qui est un lien symbolique vers /var/lib/dokuwiki/data.

En 3) les fichiers de configuration et de personnalisation.

En 4) vous trouvez /etc/apache(2)/conf.d/dokuwiki.conf qui est un lien symbolique vers /etc/dokuwiki/apache.conf.

Paramétrer Dokuwiki vous semblera nécessaire, surtout si vous avez lu jusqu'ici… La méthode recommandée pour modifier la configuration consiste à prendre des lignes de /etc/dokuwiki/dokuwiki.php et de les copier dans /etc/dokuwiki/local.php. Une description de chaque ligne de dokuwiki.php peut être trouvée ici.

Note: for me changing the $conf['userewrite'] = 0; to any other value than zero made it so that I could not access the “create new page” ability when clicking on a newly created internal link.

Here are the settings that I find useful to modify.

//File: /etc/dokuwiki/local.php
<?php
$conf['start']       = 'Demarrage';       // Nom de la page de démarrage
$conf['lang']        = 'fr';              // c'est mieux en français ...
$conf['title']       = 'DokuWiki';        // Titre
$conf['htmlok']      = 1;                 // Peut-on incorporer du code HTML ? Ceci peut endommager l'apparence de votre wiki ainsi que sa validité XHTML 0|1
$conf['autopasswd']  = 0;                 // Le mot de passe est choisi par l'utilisateur
$conf['useacl']      = 1;                 // Pour utiliser le contrôle d'accès via un nom d'utilisateur
$conf['superuser']   = '@admins';         // L'admin peut être un utilisateur ou un groupe
 
                                          //  letter, a digit, '_', '-', or '.'.
$conf['notify']      = 'my_email@somedomain.net';               // envoyer des notifications à cet email (ou vide pour désactiver)
$conf['spellchecker']= 1;                // utiliser le correcteur orthographique (PHP >= 4.3.0 et aspell installé)
$conf['pluginmanager'] = 1;              // utiliser le gestionnaire de plugins automatisé (nécessite plugin)
?>

Note: Si vous souhaitez utiliser le gestionnaire de plugins, vous devez légèrement modifier les droits sur certains dossiers comme suit :

root# chown root:www-data /usr/share/dokuwiki/lib/plugins
root# chmod 775 /usr/share/dokuwiki/lib/plugins

ne pas oublier de changer le contenu du fichier /etc/dokuwiki/apache.conf pour autoriser l'accès aux utilisateurs réseau (et internet) (changer Allow for 127.0.0.1 par Allow for All)

Attempting to use the plugin manager (after registering and logging in with username same as $conf['superuser'] in local.php) to install this plugin.

The latexrender plugin installation results in the similar errors noted at the bottom of the latexrender plugin page. Namely,

Warning: copy(a9a131d1785806355c986127b602c5a5.png): failed to open stream: No such file or directory in /usr/share/dokuwiki/lib/plugins/latex/class.latexrender.php on line 276
Warning: unlink(/tmp/a9a131d1785806355c986127b602c5a5.aux): No such file or directory in /usr/share/dokuwiki/lib/plugins/latex/class.latexrender.php on line 294
Warning: unlink(/tmp/a9a131d1785806355c986127b602c5a5.dvi): No such file or directory in /usr/share/dokuwiki/lib/plugins/latex/class.latexrender.php on line 296
Warning: unlink(/tmp/a9a131d1785806355c986127b602c5a5.ps): No such file or directory in /usr/share/dokuwiki/lib/plugins/latex/class.latexrender.php on line 297
Warning: unlink(/tmp/a9a131d1785806355c986127b602c5a5.png): No such file or directory in /usr/share/dokuwiki/lib/plugins/latex/class.latexrender.php on line 298

Steps performed:

1. Login, click Admin at the bottom of the page.
2. click plugin manager, enter the URL for the latest latexrender plugin - ie. http://darcs.erazor-zone.de/php/dokuwiki/latex/latex.tar.gz
3. insert latex test code of <latex> \nabla \cdot \mathcal{B} = 0 </latex>
4. observe error spewing forth

Solution: Need to combine two fixes found at the bottom of the latexrender page.

1. apt-get install latex-ucs This is apparently necessary, but not listed in the requirements on the plugin page.
2. chmod 777 /var/lib/dokuwiki/data/media/latex, which is owned by www-data the php script seems to need execute permissions as it was mode 666.
3. observe beautiful math formula

Hic : ça dit quelque chose à quelqu'un http://cabernet138.hd.free.fr/pluxml/?3-doku-wiki ?