L'installation de DokuWiki est très facile - en général il suffit de décompacter et de fixer les permissions ; cependant, des descriptions détaillées de divers scénarios sont données ici.

• Étape 1: Téléchargez la plus récente version sur la page de téléchargement (anglais). Cette étape est la même pour chacun.

• Étape 2: Suivez les instructions concernant votre plateforme spécifique ci-dessous.

• Étape 3: Consultez les conseils de dépannage, ils fournissent également des notes supplémentaires concernant l’installation.

• Étape 4: Lancez la page install.php dans votre navigateur puis suivez les instructions.

• Étape 5: Lorsque vous terminez l'installation de votre Dokuwiki, jetez un oeil sur son manuel et découvrez toutes ses fonctionnalités.

C'est le scénario commun pour installer DokuWiki dans un environnement de travail ou sur votre propre racine de serveur.

• assurez vous qu’Apache et PHP sont installés (la plupart des distributions de GNU/Linux sont fournies avec des modules pour Apache et PHP) - assurez vous que les versions conviennent à DokuWiki
• décompactez le fichier .tgz quelque part dans le répertoire racine de votre serveur web, par exemple :

#> cd /var/www
#> tar -xzvf /path/to/downloaded/dokuwiki-YYYY-MM-DD.tgz

• renommez le répertoire si vous le souhaitez

#> mv dokuwiki-YYYY-MM-DD dokuwiki

• créez un fichier de log vide

#> touch dokuwiki/data/changes.log

Si vous souhaitez utiliser le dispositif de contrôle d'accès (ACL), vous devez créer les fichiers users.auth.php et acl.auth.php (juste un utilisateur, TL)

#> cp dokuwiki/conf/users.auth.php.dist dokuwiki/conf/users.auth.php
#> cp dokuwiki/conf/acl.auth.php.dist dokuwiki/conf/acl.auth.php

• Etablissez les bonnes permissions
  • Habituellement le serveur web s'exécute en tant qu'utilisateur non privilégié par exemple, www-data, ou apache.
  • Le serveur web doit pouvoir écrire dans certains fichiers et répertoires (par exemple modifiez les droits de nobody en droits apache pour adapter votre configuration …)
  • Si vous utilisez le contrôle d'accès, vous devez modifier les droits de propriété de groupe sur les fichiers appropriés et les rendre exécutables par le groupe d'utilisateurs du serveur web (utilisez les propriétés de groupes, car en tant qu’utilisateur web et administrateur du site, vous devrez éditer les fichiers directement) - sinon, les utilisateurs ne pourront pas s'enregistrer, et vous ne pourrez pas placer de commandes ACL par l'intermédiaire de l'interface Web, et vous recevrez des messages d'erreur ; J'oublie toujours ces étapes quand je fais une installation en utilisant les dispositifs ACL, c’est pourquoi je les ajoute ici.
  • Le nom de groupe sous lequel le serveur web s’exécute est habituellement identique au nom d'utilisateur, sauf dans le cas de la combinaison « nobody/nogroup » et « wwwrun/www » - mais contrôlez votre configuration de serveur juste dans ce cas (juste un utilisateur, TL)

#> chgrp nogroup dokuwiki/conf/users.auth.php 
#> chgrp nogroup dokuwiki/conf/acl.auth.php
#> chmod 664 dokuwiki/conf/users.auth.php 
#> chmod 664 dokuwiki/conf/acl.auth.php

#> chown -R nobody dokuwiki/data

• éditez le fichier dokuwiki/conf/dokuwiki.php (voir les configurations) si vous voulez y modifier quoi que ce soit. Encore mieux, créez un fichier dokuwiki/conf/local.php contenant les lignes de dokuwiki.php que vous voulez modifier. De cette façon, vos modifications sont préservées lors d’une mise à jour par une nouvelle version qui écrase le fichier dokuwiki.php. La commande suivante peut vous aider à créer le fichier. Effacez les lignes que vous ne voulez pas modifier.

#> cp dokuwiki/conf/dokuwiki.php dokuwiki/conf/local.php

• pour finir, faites un test de contrôle. Utilisez l’URL de contrôle http://127.0.0.1/dokuwiki/doku.php?do=check que vous taperez dans la barre d’adresse de votre navigateur.

• si vous utilisez les dispositifs de contrôle d'accès, vous devrez vous même vous établir en tant qu'utilisateur administrateur (ajoutez votre compte d'utilisateur à l'entrée appropriée dans le fichier dokuwiki.php ou local.php, ou mettez votre compte dans le groupe d'administrateurs que vous avez indiqué dans ces fichiers), afin que le bouton « admin » apparaisse quand vous ouvrez une session (juste un utilisateur, TL)

Des packages officiels de Debian, maintenus par Mohammed Adnène Trojette, peuvent être trouvés avec apt pour les distributions testing et unstable. La page d’accueil pour ce .deb est http://packages.debian.org/unstable/web/dokuwiki. (anglais)

Pour Ubuntu, DokuWiki est fourni par le dépôt « universe ». Consultez ceci (anglais) pour obtenir des instructions sur la manière de l’ajouter à votre système. Une fois que vous l'avez ajouté, vous pourrez continuer avec ce guide. Rappelez-vous que toutes les commandes apt-get doivent être exécutées sous compte « root » (utiliser « sudo »).

Pour installer DokuWiki, employez le procédé standard de Debian :

#> apt-get update 
#> apt-get install dokuwiki

Le package est décompressé, debconf pose quelques questions, et il le configure. Vous pouvez alors invoquer DokuWiki à l’aide de votre navigateur. Par exemple, si vous avez indiqué /dokuwiki comme étant l'emplacement web de votre installation, l'accès depuis l’hôte local seulement doit être, http://localhost/dokuwiki il affichera la page de démarrage.

Employez le système bug tracking de Debian pour enregistrer toutes les anomalies avec le package http://www.debian.org/Bugs/ (anglais).

Malheureusement, en raison d’ imperfections de structures des applications web de Debian, le soutien du module des installations multisites est plutôt limité.

Notes sur l’installation et l’usage du module unstable de Debian en date du 29 janvier 2006.
Plus de détails sur l'installation de la dernière version sur debianpackage (anglais)
De plus, sous Debian, les fichiers de configuration sont placés dans /etc/dokuwiki.

Le systeme de droit sur les fichiers ne permet pas d'utiliser tout de suite Dokuwiki. Il faut commancer par modifier le fichier /etc/dokuwiki/apache.conf et remplacer 127.0.0.1 par all. Puis redémarrer apache avec la commande /etc/init.d/apache restart.

Pour installer DokuWiki sur FreeBSD en utilisant l'arborescence de ports, procédez comme suit :

#> cd /usr/ports/www/dokuwiki
#> make install clean

Le répertoire par défaut de DokuWiki est /usr/local/www/dokuwiki – Bien entendu, vous pouvez déplacer ce répertoire ou y accéder de n'importe où en créant un lien symbolique.

Pour configurer dokuwiki, copier les options du fichier /usr/local/www/dokuwiki/conf/dokuwiki.php que vous souhaitez modifier dans /usr/local/www/dokuwiki/conf/local.php.

De cette manière, les modifications que vous apporterez à votre configuration ne seront pas écrasées par le portupgrade lors d'une mise à jour.

Pour mettre à jour dokuwiki, faites simplement :

#> portupgrade dokuwiki

Assurez-vous bien que l'arborecence de ports a été mise à jour avant.

Pour installer dokuwiki sous Gentoo, faites:

$> emerge --sync
$> emerge -a dokuwiki 

Ceci installera dokuwiki dans /var/www/localhost/htdocs/dokuwiki.

N'oubliez pas de configurer le support de PHP dans Apache (le serveur web). Cf. http://gentoo-wiki.com/Apache_Modules_mod_php.

Apache et PHP sont pré-installés sur Mac OS X client, mais sont inactifs par défaut. Les instructions qui suivent fonctionnent pour les clients Tiger (10.4.x) et Panther (10.3.x) (si aucune version précédente de DokuWiki n'est installée) :

1. Activer PHP sur Mac OS X ou Télécharger PHP 5 sur le site de Marc Liyanage
2. Démarrez le partage Web personnel dans les Préférences Système → Démarrer
3. Téléchargez dokuwiki-yyyy-mm-dd.tgz (vers le répertoire ~/Desktop)
4. Dans le Terminal :

   $ cd ~/Desktop && tar -zxvf dokuwiki-yyyy-mm-dd.tgz
   $ mv dokuwiki-yyyy-mm-dd ~/Sites/dokuwiki
   $ cd ~/Sites/dokuwiki
   $ sudo chown -R www data conf

Vous pouvez maintenant démarrer l'installation à l'adresse http://localhost/~votre_nom_d_utilisateur/dokuwiki/install.php

• Consultez aussi les notes ci-dessous, à la fin de la rubrique Mac OS X Server

Pour les serveurs Tiger (10.4.x) et Panther (10.3.x) :

1. Apache et PHP sont pré-installés sur Mac OS X Server ; ils sont activés avec l'application Admin Server. Activez “php4_module” dans Web → Modules, et démarrez (ou redémarrez) et configurez le service web.
2. Download dokuwiki-yyyy-mm-dd.tgz (vers le répertoire ~/Desktop)
3. Avec le Terminal :

   $ cd ~/Desktop && tar -zxvf dokuwiki-yyyy-mm-dd.tgz
   $ mv dokuwiki-yyyy-mm-dd ~/Sites/dokuwiki
   $ cd ~/Sites/dokuwiki
   $ sudo chown -R www data conf

Vous pouvez maintenant démarrer l'installation à l'adresse http://localhost/dokuwiki/install.php

• Le paquet Apache2 est exécuté comme 'nobody' et non 'www' – modifiez les commandes chown en conséquence
• Si vous modifiez « manuellement » des fichiers config, assurez-vous que les fins de lignes sont enregistrées au format UNIX (LF) et non Mac (CR)
• Un how-to un peu ancien HOWTO for DokuWiki on Tiger est disponible en anglais.

Cette section n'est pas encore traduite !

Veuillez suivre ce lien pour afficher le texte original correspondant en anglais. Revenez ensuite ici pour y coller votre traduction !

Pour les personnes qui souhaitent utiliser Dokuwiki sur leur PC Windows

• Vérifiez que vous avez bien Apache et PHP d'installés (Le plus simple est d'utiliser les packages d'installation disponibles sur Uniserver, XAMPP, AppServ, EasyPHP)
• Décompressez l'archive tar avec un utilitaire de type WinZIP, WinRAR ou encore 7-Zip qui est libre et gratuit.
• Déplacez le répertoire dokuwiki-YYYY-MM-DD dans un répertoire sur votre serveur web. Ex : c:\xampp\htdocs et renommez le en dokuwiki.
• Dans le répertoire dokuwiki/data/, créez un nouveau fichier vide changes.log (clic-droit, sélectionnez Nouveau → Document Texte, puis nommez le fichier comme indiqué).
• Editez le fichier dokuwiki.php rangé dans le répertoire conf, pour configurez le wiki (voir config) ou (mieux) créez un nouveau fichier conf/local.php contenants les quelques lignes provenant du fichier dokuwiki.php que vous souhaitez changer. De cette façon, vos modifications sont conservées en cas d'une nouvelle version du fichier dokuwiki.php.

* Dans la dernière version (2006-03-09) vous aurez à créer un répertoire manquant data/meta. Pour les utilisateurs des précédentes versions, vous aurez également à créer les répertoires data/cache, data/meta, data/locks.

• Votre nouveau wiki sera accessible à l'adresse http://127.0.0.1/dokuwiki/doku.php

Cette section n'est pas encore traduite !

Veuillez suivre ce lien pour afficher le texte original correspondant en anglais. Revenez ensuite ici pour y coller votre traduction !

Cette section n'est pas encore traduite !

Veuillez suivre ce lien pour afficher le texte original correspondant en anglais. Revenez ensuite ici pour y coller votre traduction !

Vous pouvez aussi vérifier la plus récente version en développement en utilisant darcs.

Cette section n'est pas encore traduite !

Veuillez suivre ce lien pour afficher le texte original correspondant en anglais. Revenez ensuite ici pour y coller votre traduction !

Avant la mise à jour, il vaut mieux lire les changelogs pour voir si la mise à jour ne va pas entraîner de grosses modifications.

Pour déterminer votre version de Dokuwiki, regardez dans les sources des pages HTML générées par Dokuwiki (CTRL U). Il devrait y avoir quelque chose comme <meta name=“generator” content=“DokuWiki 2005-02-06” />.

La façon la plus simple de mettre à jour est de suivre ces indications :

1. Faire une mise à jour complète de votre wiki (on ne sait jamais…)
2. Télécharger et décompresser la dernière version.
3. Copier/Télécharger tous ces fichiers par-dessus votre ancienne installation, en écrasant tous les fichiers existants.
4. Enlever tous les anciens fichiers qui ne sont plus utilisés (voir la liste ici)
5. Fixer les permissions si nécessaire, incluant la possibilité de nouveaux répertoires sous data/ comme index/
6. Mettre les plugins à jour

A noter : si vous faites une mise à jour depuis une ancienne version et que vous n'avez plus de login, vous devez modifier le fichier conf/local.php, c'est que la ligne

$conf['useacl'] = 1; 

est manquante. Cela arrive le plus souvent si vous avez édité conf/dokuwiki.php au lieu de conf/local.php pour vos paramètres locaux. Vous devrez modifier les autres entrées dans l'ancien conf/dokuwiki.php également.

Veuillez suivre ce lien pour afficher le texte original correspondant en anglais.

Cette section n'est pas encore traduite !

Veuillez suivre ce lien pour afficher le texte original correspondant en anglais. Revenez ensuite ici pour y coller votre traduction !

Cette section n'est pas encore traduite !

Veuillez suivre ce lien pour afficher le texte original correspondant en anglais. Revenez ensuite ici pour y coller votre traduction !

Cette section n'est pas encore traduite !

Veuillez suivre ce lien pour afficher le texte original correspondant en anglais. Revenez ensuite ici pour y coller votre traduction !

Cette page est partiellement traduite !

Veuillez suivre ce lien pour afficher le texte original en anglais. Revenez ensuite ici pour y coller votre traduction !

Plus d'informations sur la traduction des pages.

• Philippe LAPEYRIE 2006-05-21 21:08
• Nicolas DIETLIN 2006-11-20 08:56