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 ce tutorial
  • Configurer votre sous-domaine pour pointer vers le serveur que vous venez de configurer, comme vous l'explique 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 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 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 traduction de la documentation officielle!

Dernière modification: le 03/06/2013 à 16:12 par Alexandre J. (Gandi)