Retrouvez cet article dans : Linux Pratique 35

Mediawiki est le logiciel qui fait tourner Wikipédia, probablement l'encyclopédie libre la plus célèbre. Elle a beau proposer quelques centaines de milliers d'articles, Wikipédia n'est pas autre chose qu'un simple wiki, à savoir un logiciel qui vous permet d'éditer et de mettre en ligne des articles rapidement. Cela peut se révéler intéressant dès que vous voulez mettre en place une base de connaissances ou un site web rapidement. Dans notre cas, nous allons baptiser notre base de connaissances du joyeux nom de "bloc-note".

Cet article a été écrit avant la sortie des versions de la série 1.6. Cette nouvelle version ne diffère pas ou très peu de ce que vous pouvez lire dans cet article. De plus, quatre versions de la série 1.6 se sont succédées en quelques jours, ce qui est preuve d’une instabilité de ces nouvelles versions. Si au moment de la parution de ce numéro la version est toujours 1.6.3, nous pourrons la considérer comme stable. Sinon,attendez encore un peu ou utilisez la version 1.5.8

Les pré-requis

Pour installer Mediawiki, nous allons avoir besoin d'une liste habituelle de pré-requis : une base de données MySQL, de PHP, et bien entendu d'un serveur web tel qu'Apache. Vous n'aurez aucune difficulté à les installer via le gestionnaire de paquets (rpmdrake, synaptic...) et les paquets qu'offre votre distribution favorite. Pour une distribution récente, vous pourrez ainsi disposer d'apache-2.0 ou supérieur, de mysql 4 ou 5 et de php 4 ou 5, ce qui convient pleinement pour Mediawiki.
Pour utiliser une version récente du wiki, mieux vaut télécharger la dernière version disponible sur le site, soit la 1.5.7 lors de la rédaction de cet article. Nous partirons du principe que vous aurez décompacté l'archive dans /var/www, mais vous pouvez vous placer à l'endroit qui vous convient, en particulier si vous n'avez pas les droits d'écriture dans ce répertoire.

$ cd /var/www
$ tar xvzf mediawiki-1.5.7.tar.gz

Configuration des outils

Le serveur web

Lorsque les pré-requis sont en place, nous passons à la configuration. Commençons par le serveur Apache : il faut lui indiquer votre répertoire Mediawiki. Pour cela, éditez le fichier de configuration apache2.conf de votre serveur web, qui se trouve généralement non loin de /etc/httpd/ ou /etc/apache/. Vous ajouterez les lignes suivantes avant de relancer le serveur web :

Alias /wiki "/var/www/mediawiki-1.5.7"
<Directory "/var/www/mediawiki-1.5.7">
    AllowOverride AuthConfig
    Order allow,deny
    Allow from all
</Directory>

Ces quelques lignes permettent au serveur d'avoir connaissance du répertoire où se trouve Mediawiki et de donner l'accès aux utilisateurs, via l'alias /wiki. Si votre serveur se trouve sur votre machine, vous pourrez donc, après relance du serveur, aller voir sur http://localhost/wiki/.

La base de données

Mediawiki est capable de créer sa base et l'utilisateur qui y accède, comme vous le verrez lorsque nous le configurerons. Vous devez pour cela indiquer le mot de passe de l'administrateur MySQL. Si vous n'avez pas accès à MySQL, vous pouvez demander à l'administrateur de vous créer la base, avec les commandes suivantes :

mysql> create database wikidb;
mysql> grant all on wikidb.* to 'wikiuser'@'MACHINE' identified by 'MOTDEPASSEENCLAIR';

Vous changerez bien évidemment MACHINE par votre machine, celle qui héberge Mediawiki, ainsi que le MOTDEPASSEENCLAIR par un mot de passe qui ne devrait vous servir qu'une seule fois, lors de la configuration de Mediawiki. Si vous préférez, vous pouvez également utiliser l'interface de PHPMyAdmin pour créer votre base de données (puis les tables seront créées automatiquement lors de l'installation de Mediawiki).

Installation

L'installation de Mediawiki est d'une simplicité enfantine. Vous avez décompacté l'archive de Mediawiki dans /var/www.
Allez maintenant sur le site http://localhost/wiki/ (remplacez localhost par le nom de la machine si nécessaire) et suivez les instructions. Il se peut qu'un accès en écriture au répertoire config/ vous soit demandé. Pour cela, vous pouvez, de façon temporaire, changer les permissions ainsi :

cd /var/www/mediawiki-1.5.7
chmod 777 config/

Rechargez ensuite la page précédente (http://localhost/wiki/config/index.php).

Configuration

Voyons la configuration plus en détail. La plupart des champs se passent de commentaire. Vous devez néanmoins prêter attention aux suivants :

• 1. Site Name : c'est le petit nom que vous donnez à votre site, par exemple "Bloc Note".
• 2. Contact e-mail : c'est votre adresse électronique pour vous avertir dès qu'il y a un problème, ainsi que pour vous rappeler l'un ou l'autre mot de passe que vous pourriez avoir oublié.
• 3. Language : mettez ici la langue que vous préférez.
• 4. Sysop account name/password : identifiant et mot de passe de l'administrateur du wiki. Ce n'est ni le compte root, ni l'administrateur de la base, ni même l'utilisateur ayant les droits d'accès à la base de Mediawiki. Il correspond à l'utilisateur qui aura par exemple le droit de modifier les liens de la barre latérale.
• 5. Mysql Server, Database name,DB user/password : ce sont les paramètres relatifs à la base. Le premier est la machine hébergeant la base, soit localhost, soit MACHINE comme nous l'avons vu plus haut. Le nom de la base est généralement wikidb. L'utilisateur est wikiuser et le mot de passe est MOTDEPASSEENCLAIR si vous avez suivi la procédure précédente. Sinon, vous pouvez laisser l'installeur faire le travail (voyez le point 7) à partir de ce que vous indiquez ici. Database table prefix est le préfixe qu'aura chaque table afin de distinguer les tables de Mediawiki de celles d'une autre application dans l'hypothèse où votre base serait mutualisée entre plusieurs applications. Vous pouvez sans problème indiquer mw_ ici.
• 6. Database Charset : c'est le jeu de caractères de la base. Pour une nouvelle installation sur un MySQL 5, vous pouvez cocher le choix expérimental si vous voulez tester. Dans tous les autres cas, prenez l'UTF-8 compatible avec les versions précédentes.

• 7. Super user/password : ceci est l'identifiant et le mot de passe de l'administrateur de la base. Si votre base n'a pas été créée au préalable, vous pouvez faire le nécessaire ici pour que Mediawiki le fasse automatiquement pour vous. Si vous n'êtes pas un expert des bases de données et que personne n'est là pour faire le travail à votre place, nous vous conseillons de donner les billes à Mediawiki.
  Cliquez enfin sur Install. A la fin de l'opération, si la mention Installation successfull s'affiche à l'écran, vous pourrez aller sur votre site : http://localhost/wiki/ : il est prêt à l'emploi !
  Maintenant que le logiciel est configuré, il faut déplacer le fichier LocalSettings.php et vous assurer que le répertoire config/ n'est plus accessible en écriture pour tout le monde :

cd /var/www/mediawiki-1.5.7
mv config/LocalSettings.php ..
chmod 700 config

Votre première page

Mediawiki est un logiciel convivial. Vous pouvez vous en rendre compte si vous lisez les onglets tels que Modifier pour modifier le contenu, ou Historique pour voir l'historique de la page. Aussi, nous vous invitons à éditer la page d'accueil en modifiant celle existante. Vous pouvez par exemple écrire quelque chose comme ceci :

== Liens ==
De l'aide sur Mediawiki : [http://meta.wikimedia.org/wiki/Aide:%C3%89diteur]
== Trucs et astuces ==
=== Nouvelle page ===
Pour faire une nouvelle page, d'abord faire un lien depuis une page existante, puis cliquer sur le lien.

Ce texte donne le résultat suivant :

Vous repérez donc qu'un lien vers une autre page s'effectue en le plaçant entre crochets. Le titre correspond au nom de la page, ici "Accueil". Les titres des paragraphes se placent entre des signes == pour du niveau 1 et === pour du niveau 2. Vous pouvez descendre plus bas en ajoutant des = supplémentaires.
Pour créer une nouvelle page, vous devez d'abord faire un lien dessus. Pour cela, mettez son titre entre double crochets, comme par exemple [[Coordonnées]]. Ce titre deviendra un lien sur lequel vous pouvez cliquer. Vous arrivez alors sur une nouvelle page vierge que vous pouvez remplir à votre guise avec les numéros de téléphone de vos meilleurs amis par exemple.

Il ne vous reste plus qu'à remplir le wiki. La syntaxe est assez simple, outre les titres que nous avons vus plus haut. Vous trouverez de l'aide sur http://meta.wikimedia.org/wiki/Aide:%C3%89diteur. Si vous préférez des exemples, ne manquez pas les articles de Wikipédia (http://fr.wikipedia.org).

Fonctionnalités

Mediawiki propose quelques fonctionnalités intéressantes. Parmi celles-ci, le mécanisme des catégories attire notre attention. Ainsi, vous pouvez créer vos propres catégories de la manière la plus simple qui soit : indiquez dans laquelle (ou lesquelles) doit se trouver votre article et elle est automatiquement créée. Concrètement, éditez votre article et ajoutez, peu importe l'endroit, comme si c'était un lien vers une nouvelle page, [[Category:Documentation]] et il appartiendra à la catégorie Documentation. Cela se matérialisera par un encadré en bas de page.

Il est évidemment possible, avec Mediawiki, de faire appartenir un article à plusieurs catégories, ce qui n'est pas forcément habituel avec les systèmes de classements arborescents d'autres logiciels.
Lorsque vous avez créé une nouvelle catégorie, le lien apparaît en rouge, comme pour toute page qui n'a pas encore été éditée. Nous vous conseillons de cliquer sur le lien et d'indiquer un descriptif à la catégorie. Non seulement le lien deviendra bleu, ce qui est plus homogène avec le reste du site, mais surtout, vous vous rappellerez aisément ce que vous pouvez mettre dans la catégorie en question. Par ailleurs, l'intérêt de cette page est de proposer la liste des articles qui font partie d'une catégorie. C'est un moyen dynamique de les indexer sur la page d'accueil par exemple. C'est ce mécanisme qu'utilise Wikipedia pour ne pas obliger les administrateurs du site à référencer chaque nouvel article sur la page d'accueil.
Il existe une page spéciale listant toutes les catégories. Vous pouvez y accéder en passant par la page des pages spéciales en bas à gauche, dans la boîte à outils. Sinon, le lien direct est http://localhost/wiki/index.php/Special:Categories. Et puisque nous en sommes avec les pages spéciales, revenons à cette page qui les liste. Vous trouverez entre autres
celles-ci :

• Catégories de la page : la liste des catégories.
• Créer un compte ou se connecter : utiliser votre compte permet d'avoir un historique plus clair qu'avec des adresses IP. De plus, certains sites interdisent de modifier des pages de façon anonyme.
• Liste des participants : liste des personnes ayant un compte. Chaque lien est un lien vers la page personnelle d'un utilisateur.
• Pages orphelines : ce sont les pages qui ne sont plus indexées nulle part. C'est ici le seul moyen d'y parvenir encore, par définition.

Changez le logo

Il est probable que le logo par défaut, une image indiquant Set $wgLogo to the URL path to your own logo image, vous déplaise. Pour le changer, mettez sur votre serveur (dans le répertoire /var/www/mediawiki-1.5.7/images/) une image ayant à peu près les mêmes dimensions que celle-ci, soit 135x135. Éditez ensuite le fichier de configuration LocalSettings.php que nous avons vu au début de l'article, et changez la variable wgLogo. Mettez-y l'URL de votre image (soit http://localhost/wiki/images/nom_image.ext). Sachez que si vous faites référence à l'URL du wiki, vous pouvez utiliser $wgScriptPath.
À cet endroit, vous pourriez avoir une mauvaise surprise : le logo change sur certaines pages mais pas sur d'autres. Ici comme dans le cas général, lorsque vous avez vu une page web et que vous vous attendez à ce qu'elle ait été modifiée depuis, vérifiez qu'elle n'est pas dans le cache de votre navigateur. Ou plutôt, videz ce cache. Puis rechargez à nouveau la page.
Mediawiki peut également avoir été installé de façon à disposer de son propre cache. Pour purger une page de ce cache, vous pouvez ajouter en fin d'URL ceci : ?action=purge. Pour la page d'accueil, cela donne http://localhost/wiki/index.php/Accueil?action=purge.

Modifiez les liens de navigation

En haut à gauche, dans la boîte, certains liens vous sont inutiles, ou vous devez en ajouter. Pour cela, vous devez vous connecter en tant qu'administrateur de Mediawiki : utilisez le compte wikiadmin que nous avions défini lors de la configuration. Pour vous connecter, cliquez sur le lien Créer un compte ou se connecter qui se trouve en haut de la page. Vous pouvez ensuite aller sur http://localhost/wiki/index.php/MediaWiki:Sidebar. Il ne vous reste plus qu'à éditer cette page et à la valider. La syntaxe des liens est inhabituelle par rapport à ce que nous avons vu plus haut. En effet, vous devez indiquer l'URL, mettre une barre verticale, et l'intitulé du lien, comme sur la capture suivante. Par rapport aux valeurs par défaut, nous en avons retirées et avons ajouté la page des catégories. Voyez l'édition de la page ainsi que le résultat à sa gauche :

Conclusion

Mediawiki est un wiki très intéressant du point de vue de ses possibilités. Il est ainsi possible de changer de thème, d'ajouter ses propres extensions (lire un répertoire, utiliser un plugin pour Freemind...). Mais vous pouvez très bien l'utiliser tel quel comme base de connaissances, voire faire votre site web ainsi – vous ne seriez pas le premier.
Avant de vous laisser foncer vers l'aide de l'utilisateur pour éditer vos pages, nous vous donnons encore un dernier conseil : avant de sauvegarder, pensez à systématiquement prévisualiser le résultat. Vous éviterez ainsi, à la moindre erreur, de sauvegarder une version qui apparaîtra de toute façon dans l'historique et comporte une erreur que vous auriez pu corriger. Et maintenant, à vos claviers !

Références

•  Mediawiki : http://www.mediawiki.org
•  Manuel de Mediawiki :
  http://meta.wikimedia.org/wiki/Aide:Manuel_de_MediaWiki
•  Aide de l'éditeur :
  http://meta.wikimedia.org/wiki/Aide:%C3%89diteur