#language fr ||~-Traduction(s): [[DokuWiki|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. * [[http://packages.debian.org/search?lang=fr&keywords=dokuwiki|Aperçu des paquets]] * [[http://packages.qa.debian.org/dokuwiki|Aperçu technique et nouveautés]] * [[http://bugs.debian.org/dokuwiki|Rapports de bugs]] == 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 [[http://www.debian.org/doc/debian-policy/|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 [[http://bugs.debian.org/dokuwiki|ici]]. Voici les problèmes les plus importants qui pourraient être rencontrés: * Impossible d'activer fastcgi avec le serveur web lighttpd [[http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=611254|#611254]] === Rapports de Bugs === Merci d'envoyer un rapport de bug en utilisant le [[http://bugs.debian.org/|système de suivi des bugs de Debian]]. Voir aussi la [[http://bugs.debian.org/dokuwiki|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}}} {{{ ServerName cat.yourdomain.tld DocumentRoot /usr/share/dokuwiki }}} {{{/etc/apache2/sites-available/dog}}} {{{ ServerName dog.yourdomain.tld DocumentRoot /usr/share/dokuwiki }}} 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 [[http://www.debian.org/doc/debian-policy/|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 [[tips:farm|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]] [[http://www.dokuwiki.org/install:debian]] [[http://www.dokuwiki.org/tips:farm]]