Configurer Mediawiki

Un article de Wikipatate.

Vous avez un wiki, mais... les menus ne sont pas personnalisés, les textes par défaut (comme par exemple celui qui se trouve en dessous de la boîte d'édition) sont à votre goût peu conviviaux, vous voudriez permettre aux utilisateurs de s'envoyer des mails... Voici quelques trucs et astuces pour personnaliser et configurer votre Mediawiki...

Note: Dans cet article, nous considérons que le répertoire d'instalation de Mediawiki est / et que le réperoire contenenant les fichier de MediaWiki est /wiki l'arborescence de votre site est donc :

/-+/sessions
  |
  +/wiki-+/includes
  |      |
  |      +/skins
  |      |
  |      +/et cætera
  +/vos
  |
  +/autres
  |
  +/applications web

Un peu de technique d'abord

En fonction de ce que vous désirez changer, il existe deux techniques pour y parvenir

1. La première, un peu barbare, consiste à modifier le fichier « LocalSettings.php » situé sur votre serveur à la racine de votre wiki. Pour cela, il faut que vous modifiiez une copie de ce fichier sur votre ordinateur local et que vous l'envoyiez via votre [[|File Transfer Protocol|client FTP]] favori écraser le fichier du même nom situé sur le serveur. Toutes les options que vous pouvez modifier grâce à ce fichier sont définies par défaut dans le fichier /wiki/includes/DefaultSettings.php. Lorsqu'une page est appelée, Mediawiki charge d'abord DefaultSettings.php, puis modifie la configuration ainsi obtenue en fonction de LocalSettings.php. Il ne faut en théorie jamais modifier DefaultSettings.php, car les modifs seraient perdues lors de la prochaine mise à jour de Mediawiki. Cependant, passer via LocalSettings.php peut parfois s'avèrer compliqué, car l'ordre des paramètres a son importance, et certaines modif peuvent échouer si elles ne sont pas placées au bon endroit de ce fichier. Le plus simple alors est de modifier directement DefaultSettings.php, même si ce n'est pas très orthodoxe. Simplement, dans ce cas, vous devrez vous en souvenir si vous désirez mettre Medaiwiki à jour.
2. La deuxième, plus douce, consiste à modifier des pages de l'espace Mediawiki. Par exemple, la page Mediawiki:Sidebar permet de configurer le menu de la colone de gauche. Pour y accéder, tapez son nom dans la boite « rechercher ». Pour pouvoir la modifier, vous devez avoir les droits d'administrateur

Un dernier point. Il peut arriver que les modifications attendues ne s'affichent pas. En fait, Mediawiki et votre navigateur ont tendance à mettre beaucoup de choses en cache (technique qui consiste à mettre des petits bout de page, voire des pages entières en mémoire pour pouvoir le ressortir plus rapidement par la suite), et les modifs peuvent ne pas apparaître. Essayez d'abord de vider le cache de votre navigateur, et si cela ne marche pas, il faut effectuer une requête SQL du type (TRUNCATE TABLE `objectcache`) (ça parait barbare, comme ça, mais lisez l'article (quand il sera écrit :þ ), c'est enfantin).

Esthétique générale

Commençons par ce qui est complètement superflux donc absolument indispensable, l'esthétique de votre wiki.

Comment modifier le logo?

• Créez votre logo, une image de 135x135 pixels au maximum au format .png (jpg marche aussi, mais sapucépalibre)
• Envoyez-le via FTP dans /wiki/skins/common/images
• Dans /wiki/LocalSettings.php remplacez la ligne

$wgLogo = "$wgStylePath/common/images/wiki.png";

par

$wgLogo = "$wgStylePath/common/images/mon_beau_logo.png";

• Faites admettre (par la force s'il le faut) que le manchot en tampons patate de votre fille est un logo idéal (d'expérience, c'est pas gagné)

Comment faire apparaître un charmant petit logo dans la barre d'adresse du navigateur

• Créez votre logo, une image de 24x24 pixels au maximum au format .ico nommé favicon.ico (the Gimp le fait très bien)
• Envoyez-le via FTP dans /
• C'est tout!

Images

Comment permettre le chargement d'images (et d'autres media)

• Via votre client ftp, réglez les permissions de /wiki/images (en fonction de votre client FTP, un clic droit sur ce dossier puis «modifier les permissions » ou « chmod ») à 777 soit lecture, écriture et execution pour tous les groupes. Notez que certains fournisseur d'accès empêchent cette modif dans les espaces perso (Free.fr par exemple) ce qui interdit l'upload d'images
• Dans le fichier /wiki/LocalSettings.php, remplacez

$wgEnableUploads = false;

par

$wgEnableUploads = true;

Sources

La FAQ MediaWiki Aide:Personnalisation chez meta.wikimedia.org

Licence

© Les auteurs. Cette page est sous licence WTFPL.