Introduction

Pourquoi Dokuwiki ?

Si vous ne connaissez pas ce genre d’outil, rendez-vous sur Wikipédia : Wiki pour en apprendre un peu plus.

Dokuwiki est simple à installer et à utiliser. De plus il est possible de faire beaucoup de choses avec, car le développement de vos propres plugins est assez facile pour peu que vous ayez quelques notions de programmation.

A savoir

L’intérêt d’un tel site, c’est qu’il vous permet d’établir une documentation interne complète, que ce soit pour votre entreprise ou toute autre organisation, jeu, univers, etc…

Ce tutoriel est normalement compatible avec n’importe quel debian-like (Debian, Ubuntu, Mint…). Les commandes devront donc être adaptées si vous utilisez d’autres distributions Linux.

Prérequis

  • Une distribution Linux
  • Un serveur Web : Apache ou nginx par exemple.
sudo apt-get install apache2
  • Vous devez avoir Php d’installé :
sudo apt-get install php5

C’est tout.

Téléchargement et installation

Sur certaines distributions, il est tout à fait possible d’installer Dokuwiki en une seule commande (sudo apt-get install dokuwiki).

Cependant, je vous déconseille de faire ça.

L’installation par paquet installe Dokuwiki dans plusieurs dossiers, ce qui n’est pas forcément le meilleur choix. Autant tout mettre dans le même dossier pour faciliter les futures mises à jour. Vous allez voir c’est très simple et tant qu’à faire, autant installer votre serveur là ou vous voulez !

Rendez-vous sur la page de téléchargement de Dokuwiki et copiez le lien de la version “Stable”.

Ouvrez un terminal et collez le lien copié :

cd /var/www/
sudo wget http://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz

Décompressez l’archive téléchargée et renommez la :

sudo tar xzvf dokuwiki-stable.tgz
sudo mv dokuwiki-DATE-VERSION monwiki
sudo rm dokuwiki-stable.tgz

Donnez les droits à l’utilisateur du serveur Web (www-data pour Apache) :

sudo chown -R www-data:www-data data conf

Voilà le dossier de votre serveur est prêt.

Configurer Apache

Il va falloir maintenant aller dire à Apache de nous faire tourner tout ça. Si Apache n’est pas installé, installer le maintenant (sudo apt-get install apache2).

Rajoutez un fichier de configuration pour votre Wiki dans le dossier de votre serveur web.

sudo vi /etc/apache2/sites-available/monwiki.conf

Note : il est possible qu’Apache n’accepte pas les fichiers avec une extension .conf et produise donc une erreur lors du rechargement ou du démarrage d’Apache. Enlevez simplement l’extension, cela devrait résoudre le problème.

Renseignez ensuite votre configuration :

<VirtualHost *:80>
    # Détails du serveur
    ServerName monwiki.domaine.com
    ServerAlias monalias
    
    ServerAdmin admin@mail.com

    # Options
    DocumentRoot /var/www/monwiki
    <Directory /var/www/monwiki>
    Options Indexes FollowSymLinks MultiViews
      Order allow,deny
      allow from all
    </Directory>

    # Logs
    ErrorLog ${APACHE_LOG_DIR}/wiki_error.log
    CustomLog ${APACHE_LOG_DIR}/wiki_access.log combined

</VirtualHost>

Activer le site et rechargez votre serveur web :

sudo a2ensite monwiki.conf
sudo service apache2 reload

Ouvrez votre navigateur et entrez l’adresse suivante en remplaçant ip_serveur par votre ip :

http://ip_serveur/install.php

Vous devriez voir la page d’installation de Dokuwiki.

Si vous ne voyez rien ou que vous avez une page d’erreur, relisez ce tutoriel. Sinon vérifiez les logs d’Apache.

Arrivée sur l’interface

Maintenant que vous avez un serveur opérationnel, vous devez le personnaliser.

Remplissez les différents champs :

  • Donnez un nom à votre wiki.
  • Choisissez un utilisateur root et un mot de passe (ce sera le login de l’administrateur du wiki, mais vous pourrez en rajouter d’autre par la suite)
  • Faites un choix entre les différentes politiques du wiki.

Et cliquez sur Save.

Si tout se passe bien, vous devriez arriver sur la page d’accueil de votre wiki. Vous pouvez vous connecter avec le compte root que vous avez précédement créé.

Conclusion

Monter un wiki avec Dokuwiki est d’une extrême simplicité. De plus il existe de nombreux plugins et de nombreux thèmes pour le personnaliser.