Contents
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:
- est géré par le gestionnaire de paquet (évidemment), qui vous permet de mettre à jour et d'obtenir des mises à jour de sécurité pour le système;
- a des chemins spécifiques, essentiellement:
la racine de DokuWiki: /usr/share/dokuwiki,
les données du wiki: /var/lib/dokuwiki/data,
les fichiers de configurations: /etc/dokuwiki;
- est initialement configuré par le gestionnaire de paquet, non pas par la page web d'installation;
- gère la configuration de votre serveur web pour vous donner accès à votre wiki;
utilise des librairies déjà packagées plutôt que quelques embarquées comme Geshi ou ?SimplePie.
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:
- certains avantages: intégration dans le système, facilité la configuration initiale;
- certains inconvénients: chemins inutiles et certains bugs spécifiques.
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:
Impossible d'activer fastcgi avec le serveur web lighttpd #611254
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:
- the web servers to configure and whether or not to restart them to apply the configuration;
the web path where your wiki is to be available, that is, /dokuwiki, /wiki or whatever;
- the access scope of your wiki: local host, LAN or Internet;
- if you choose LAN, your LAN IP address range;
- whether or not to remove the wiki data when purging the package;
- whether or not to allow configuration and plugin administration from the web interface;
- the wiki title, license and ACL;
- wiki admin name, password, full name, email address and password.
All these questions do not have the same priority:
low: those whose default values are relevant in most cases, for instance web path (default /dokuwiki);
medium: those with a reasonable default value, for instance wiki admin name (default “admin”);
high: those whith no reasonable default value, for instance wiki admin password (no default!).
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.
copy /etc/dokuwiki/local.php.dist to /etc/dokuwiki/local.php and edit according to your local needs. Make sure, the option useacl is enabled.
- allow www-data to read and write the config files
chown -R www-data /etc/dokuwiki/
chown -R www-data /usr/share/dokuwiki/lib/
copy the disabled examples of authentification files to where dokuwiki expects them (or run the ?:installer):
cp /etc/dokuwiki/acl.auth.php.dist /var/lib/dokuwiki/acl/acl.auth.php
cp /etc/dokuwiki/users.auth.php.dist /var/lib/dokuwiki/acl/users.auth.php
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:
/etc/dokuwiki: configuration de DokuWiki
/usr/share/dokuwiki: racine de DokuWiki
/var/lib/dokuwiki/data: données du wiki. Si il ne fallait en sauvegarder qu'un, ça serait celui-ci!
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:
Placer l'ancien contenu de /var/lib/dokuwiki/data dans le nouveau répertoire data de la nouvelle installation.
- Vous pouvez aussi tenter de restorer:
les fichiers de configuration, présents dans /etc/dokuwiki;
les plugins, présents dans /var/lib/dokuwiki/lib/plugins.
Voir aussi
http://www.dokuwiki.org/fr:dokuwiki
Je suis désolé, mais je ne parlais pas français.
The English page has (after ten or so years) undergone some substantial updates; this section is where the updates begin. I hope a native Francophone can make appropriate fixes to bring this translation in line with the current version.