====== Installer DokuWiki ======
DokuWiki est un wiki qui possède la particularité de stocker ses données dans des fichiers textes, et qui n'a donc pas besoin de base de données.

C'est notamment le wiki que l'on utilise ici-même. :)



===== Prévoir un espace dédié à DokuWiki =====

Ici, deux choix s'offrent à vous. Par souci de "propreté", vous êtes avisé de placer DokuWiki dans un répertoire au sein du sous-domaine **www** (%%www.exemple.com/wiki%%),  ou dans un sous-domaine spécifique (wiki.exemple.com).

==== Si vous préférez simplement placer DokuWiki dans un répertoire: ====

Facile! Créez un répertoire dédié dans l'emplacement souhaité (dans **htdocs**  par exemple, pour obtenir %%www.exemple.com/wiki%%)


==== Si vous voulez attribuer un sous-domaine spécifique à DokuWiki du type wiki.exemple.com: ====

Deux opérations à faire:\\

  * Configurer votre serveur pour ce sous-domaine, comme vous l'explique [[:fr/hosting/gandi-ai/configure-virtualhosts|ce tutorial]]
  * Configurer votre sous-domaine pour pointer vers le serveur que vous venez de configurer, comme vous l'explique [[fr:hosting:manage-quota:manage-website|ce tutorial]]






===== Téléchargement de DokuWiki =====

Pour commencer, nous allons le télécharger. la dernière version disponible au moment de l'écriture de ce tutorial date du 26/6/2007\\

Rien ne vaut le site officiel pour trouver le fichier compressé initial. Je conseille donc **[[http://www.splitbrain.org/_media/projects/dokuwiki/dokuwiki-2007-06-26b.tgz?id=projects%3Adokuwiki&cache=cache|ce lien]]**.\\

Maintenant que le fichier est sur votre disque dur préféré, décompressez-le. Vous voici avec un répertoire (renommons le **wiki**) contenant tout les fichiers.\\

Lancez votre client FTP préféré (Ah, vous aussi c'est [[http://www.filezilla.fr/|FileZilla]]?), connectez-vous en temps qu'**admin** sur votre serveur, et rendez-vous sur le répertoire correspondant au virtual host que vous aviez défini initialement.

Dans l'exemple en cours, le chemin de mon FTP correspondra à ceci :
  /srv/d_ma-gandi-ai/www/wiki.tutorielgandi.net/htdocs/
...a moins que vous n'ayez changé la configuration initiale des fichiers web, mais si vous l'avez fait, j'assume que vous saviez ce que vous faisiez :)\\

A ce stade, nous allons donc pouvoir mettre les fichiers du wiki sur notre Gandi AI.\\
  * Si vous avez créé un virtual host de type **wiki.mondomaine.com**, vous allez vouloir que le wiki démarre dés la première page : vous allez donc **uploader le contenu** (et non pas le répertoire en lui-même) du répertoire **wiki** dans le répertoire **htdocs** de votre sous-domaine.\\

  * Si vous n'avez que faire du sous-domaine et que vous préférez un bon vieux lien en **mondomaine.com/wiki** alors il ne vous reste plus qu'à **uploader le répertoire complet** dans **htdocs** (ou dans un autre dossier si vous en avez décidé ainsi).\\ 


===== Préparer les fichiers DokuWiki =====

Pour que DokuWiki puisse se configurer, il va avoir besoin de droits spécifiques sur certains dossiers/fichiers. Pour changer les droits sur un fichier via votre client FTP, dans la plupart des cas, il suffit de faire un click droit sur le fichier en question et chercher le bon terme dans le menu contextuel (Droits, Rights, CHMOD ou encore Propriétés). Puisque j'ai commencé à vanter les mérites de FileZilla, voyons comment faire avec ce client.\\

Pointez le fichier en question, faites un click-droit dessus et sélectionnez "**Attributs du fichier...**". La fenêtre qui s'ouvre vous propose de changer les droits du fichier de 2 façons différentes : en droits à cocher ou en valeur numérique.\\

Le but du tutorial n'étant pas de vous initier aux valeurs numériques des droits sous UNIX, il est plus facile de vous dire que vous devez simplement **remplacer la valeur numérique par 777**.\\ 

Les répertoires qui nécessitent un changement de droits sont:\\

  /conf
  /data 
  /data/attic
  /data/cache
  /data/index
  /data/media
  /data/meta
  /data/locks
  /data/pages

===== Installation de DokuWiki =====

A présent, vous pouvez utiliser votre navigateur internet pour vous rendre dans l'emplacement de l'installation votre wiki (du type //%%wiki.votresite.com/install.php%%//; //%%www.votresite.com/wiki/install.php%%//...).

Si DokuWiki a été correctement chargé sur votre serveur, et que les droits ont été correctement attribués aux dossiers concernés comme expliqué ci-dessus, vous devriez voir la première de l'installation.

En haut à droite de la page, choisissez votre langue de préférence.

Ensuite, vous aurez les champs suivants à remplir.

**Nom du Wiki**: A vous de voir...

**Activer les ACL**: Laissez cette option cochée par défaut.

**Super-utilisateur**: Choisissez l'identifiant de l'administrateur du wiki...

**Nom complet**: ... et son nom...

**Adresse de courriel**: ... et son e-mail.

**Mot de passe**: ...puis son mot de passe...

**Répéter nouveau mot de passe**: ...que vous confirmez ici.

**Politique d'ACL initiale**: Choisissez le degré d'"ouverture" de votre wiki parmis les options qui vous sont proposées.



C'est déjà fini! Tout l'avantage de ce wiki qui n'a pas besoin de base de données MySQL...

Pour toute information supplémentaire, je vous invite à consulter la [[http://wiki.splitbrain.org/wiki:fr:dokuwiki|traduction de la documentation officielle]]!