Traduction(s): English - Français


Dokuwiki

DokuWiki est disponible dans les dépôts officiels de Debian et est installable en utilisant les outils classiques de Debian.

Spécifités du paquet Debian

Contrairement à une installation classique, le paquet Debian:

Certaines de ces spécificités viennent directement du système de packaging, d'autres sont là pour respecter la politique de Debian. Ce qui a:

Problèmes spécifiques

La liste complète des bugs connus avec le paquet Debian est disponible ici. Voici les problèmes les plus importants qui pourraient être rencontrés:

Rapports de Bugs

Merci d'envoyer un rapport de bug en utilisant le système de suivi des bugs de Debian. Voir aussi la liste des bugs actuellement connus.

Installation

   aptitude install dokuwiki

Les fichiers de configuration sont dans /etc/dokuwiki/.

Les fichiers de données sont dans /var/lib/dokuwiki/.

Le wiki est disponible à l'adresse: http://localhost/dokuwiki

Starting with Debian Lenny and Squeexe with #backports, it asks you some questions for the initial configuration:

All these questions do not have the same priority:

The package will only ask you the questions which priority is higher than the one that you chose globally to be bothered with; you can set this parameter by reconfiguring the package debconf: # dpkg-reconfigure debconf

For instance, if you chose to be bothered with high priority questions only, you will not be asked for all the DokuWiki package questions. You can still reconfigure the package dokuwiki itself to get all the questions: # dpkg-reconfigure dokuwiki

Usage

After installation of the package, your dokuwiki install is available at http://localhost/dokuwiki/ (replace //localhost// with the name or IP address of your server if it is not your local computer).

Starting with Debian Squeeze, your wiki is completely usable after installation, so start using it and skip the #Lenny section that is not for you. With Lenny without backports, the initial configuration is limited though, so read the next section.

Lenny

Please upgrade your system to Squeeze or use the package from the #backports! If you really do not want to do that, read on.

For a full access from the lan or from internet, edit the */etc/apache/conf/dokuwiki.conf* file and change *127.0.0.0* to *All* for Apache2: /etc/apache2/conf.d/dokuwiki.conf

You'll likely need to restart apache for this to take effect.

For a full config that includes login and adminstration from within the wiki you have to enable ACL and change some configs. You need root privileges to use the commands.

Configuration of multisite support (farm) with virtual hosts

This option is only available in version 0.0.20101107-4 (in experimental branch). We'll show how to create two dokuwiki sites in a virtual host-based setup.

Virtual Hosts

Create two minimal virtual hosts:

/etc/apache2/sites-available/cat

<VirtualHost *:80>
   ServerName cat.yourdomain.tld
   DocumentRoot /usr/share/dokuwiki
</VirtualHost>

/etc/apache2/sites-available/dog

<VirtualHost *:80>
   ServerName dog.yourdomain.tld
   DocumentRoot /usr/share/dokuwiki
</VirtualHost>

Enable the sites:

sudo a2ensite cat
sudo a2ensite dog

Create dokuwiki sites

To create a new site, you can use the command dokuwiki-addsite(1):

sudo dokuwiki-addsite cat.yourdomain.tld
sudo dokuwiki-addsite dog.yourdomain.tld

We have now two dokuwikis: one at http://cat.yourdomain.tld and the other one at http://dog.yourdomain.tld. They share the dokuwiki code, but have independent configurations and data.

Configuration files are in /etc/dokuwiki/farm/cat.yourdomain.tld and /etc/dokuwiki/farm/dog.yourdomain.tld.

Data files are in /var/lib/dokuwiki/farm/cat.yourdomain.tld and /var/lib/dokuwiki/farm/dog.yourdomain.tld.

Remove dokuwiki sites

sudo dokuwiki-delsite dog.yourdomain.tld

Sauvegarde / restauration

Étant donné que DokuWiki n'a pas de base de données, la sauvegarde et la restauration en cas de migration (et autre) est relativement facile. Pour rappel, les trois répertoires principaux de DokuWiki sont:

Sauvegarde

Pour la sauvegarde on peut donc se contenter de sauvegarder le contenu des répertoires cités ci-dessus. Exemple:

tar cjvf dokuwiki_conf_`date +%Y-%m-%d`.tar.bz2 /etc/dokuwiki /usr/share/dokuwiki /var/lib/dokuwiki

/var/lib/dokuwiki contient aussi les répertoires acl et lib/plugins qui correspondent aux utilisateurs du wiki et aux plugins installés. Donc tant que le wiki n'est pas trop gros, on peut sauvegarder l'ensemble de ce répertoire.

Restauration

Pour une simple restauration sur une version similaire, on peut se contenter de re copier/coller les fichiers qui ont été sauvegardés.

Dans le cadre d'une migration, il vaut mieux commencer simplement par le contenu du wiki (/var/lib/dokuwiki/data) puis reprendre étape par étape les fichiers de configuration de DokuWiki et les différents plugins qui auraient pu être installés en plus.

Questions / réponses

Posez librement vos questions ici:

? Où se trouvent les dossiers de données?

(./) Dans /var/lib/dokuwiki pour respecter la Politique Debian et correspondre à l'organisation générale du système.

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

(./) Implementing the ?farming within the Debian package is a mid-term goal, not achieved yet. Stay tuned.

? Peut-on l'installer sur Ubuntu?

(./) Oui bien sur. Tous les paquets présents présents dans Debian se retrouvent généralement dans Ubuntu (c'est le cas de DokuWiki).

? Comment restorer des données d'une ancienne installation sur une autre machine?

(./) Il faut copier le contenu de /var/lib/dokuwiki/data de l'ancienne installation sur la nouvelle. Installer les extensions nécessaires manuellement.

? Je l'ai installé en utilisant le paquet de Debian, quel est le moyen le plus propre pour mettre à jour DokuWiki?

(./) Mettre à jour votre système (en passant de Lenny à Squeeze) ou utiliser un dépôt backport.

? J'ai installé DokuWiki en utilisant le paquet Debian, mais maintenant je veux utiliser la version téléchargeable à partir du site (celle qui ne correspond pas à la politique Debian).

(./) Récupérer DokuWiki à partir du site et l'installer en suivant les instructions. Il suffit ensuite de restorer le contenu de la version précédente:

Voir aussi

http://www.dokuwiki.org/fr:dokuwiki

http://www.dokuwiki.org/install:debian

http://www.dokuwiki.org/tips:farm