Manual:FAQ/fr

Qu'est-ce que MediaWiki ?
MediaWiki est un moteur wiki ; ce qui signifie que c'est un logiciel qui permet à un site web de contenir des pages qui peuvent être éditées par ses utilisateurs. Il est essentiellement utilisé par la Wikimedia Foundation pour faire fonctionner ses projets libres, tels que Wikipédia et Wikimedia Commons.

Quand peut-on utiliser MediaWiki ?
MediaWiki est idéal pour monter et faire tourner des sites web où on a l'intention de permettre l'édition collaborative par ses utilisateurs, comme dans le principe du wiki décrit ci-dessus. Avec un peu de paramétrage, MediaWiki peut être utilisé pour de nombreuses autres applications, et plusieurs utilisateurs du logiciel l'ont personnalisé pour leurs divers besoins.

How to start a Wiki (en anglais) sur Wikibooks fournit de l'aide sur la façon de procéder et de choisir d'installer un logiciel wiki.

Qu'est-ce que MediaWiki ne peut pas faire ?
Bien qu'ayant des applications variées, MediaWiki n'est pas utilisable pour tous les usages. En particulier, les utilisateurs doivent garder à l'esprit que le logiciel est conçu pour permettre une édition non-restrictive et ne fournit pas des restrictions d'accès très complexes par page. Les utilisateurs recherchant de telles fonctionnalités doivent plutôt utiliser des logiciels dédiés à cet usage, comme un logiciel de gestion de documents ou de contenu.

Qui a créé MediaWiki ?
MediaWiki est développé principalement par des volontaires travaillant pour la Wikimedia Foundation (à but non lucratif), en réponse à ses besoins d'un moteur wiki pour ses projets. Quelques-uns des contributeurs actifs incluent :


 * Brion Vibber, release manager
 * Tim Starling
 * Magnus Manske
 * Ævar Arnfjörð Bjarmason
 * Rob Church
 * Evan Prodromou
 * Ashar Voultoiz
 * Rowan Collins

Installation et configuration
Pour des problèmes d'installation, veuillez aller voir Installation Troubleshooter (en anglais).

Où puis-je télécharger MediaWiki ?
La dernière version stable de MediaWiki peut être téléchargée à partir de http://sourceforge.net/project/showfiles.php?group_id=34373. Vous devrez choisir un site miroir pour le téléchargement. Les fichiers sont fournis dans une archive .tar.gz.

MediaWiki peut aussi être obtenu directement à partir de notre référentiel Subversion (voir aussi fr:Subversion (logiciel)).

Comment puis-je installer MediaWiki ?
Installer MediaWiki prend entre 10 et 30 minutes (lorsqu'on utilise MySQL), et implique de télécharger/copier des fichiers, créer une base de données et un utilisateur, et exécuter le script d'installation pour configurer le logiciel.

Des instructions complètes peuvent être trouvées dans le fichier INSTALL fourni dans la distribution par archive. Il y a aussi un guide d'installation sur Meta.

Comment puis-je installer MediaWiki en utilisant un package ?
Bien qu'il existe des packages (par exemple Debian, RPM, etc.) disponibles pour installer MediaWiki sous un système d'exploitation Linux/Unix, ceux-ci ne sont pas officiellement supportés par l'équipe de développement de MediaWiki, et nous ne pouvons pas fournir d'assistance pour les installer, configurer et utiliser. Les communautés individuelles qui maintiennent de tels packages fourniront normalement le support et la documentation.

Puis-je installer plus d'un wiki sur un serveur en utilisant MediaWiki ?
Il est possible d'installer plus d'un wiki sur un serveur tant que : OU Pour plus d'information sur ces options, voir $wgDBname et $wgDBprefix respectivement.
 * Vous utilisez une base de données différente pour chaque wiki
 * Vous utilisez un préfixe de base de données différent pour chaque wiki.

Pour plus d'informations sur la configuration d'un wiki familial, voir Manual:Wiki family/fr.

Installer plusieurs wikis sur un seul serveur en utilisant une même base de données
Vous trouverez ici comment installer MediaWiki une seule fois, mais en l'utilisant pour faire fonctionner plus d'un wiki, en gardant tous les wikis dans une seule base de données - y compris des instructions pas-à-pas pour les installations de type Unix. Cette solution peut fonctionner aussi pour la plupart des serveurs partagés, également. Niveau de difficulté : novice. Voir les instructions sur ce site.

Comment puis-je configurer le moteur de recherche pour les mots de moins de 4 caractères ?
Le moteur de recherche sur l'ensemble du texte de MySQL a un ensemble par défaut de mots terminaux (stop words) qui sont ignorés, et une longueur minimale pour les mots configurée à 4 caractères par défaut.

Pour changer cela, vous devez reconfigurer MySQL, voir http://dev.mysql.com/doc/mysql/en/fulltext-fine-tuning.html.

Sinon, cela concerne MySQL de façon générique, et n'a aucun rapport avec MediaWiki.

Ainsi, si vous prenez toutes les configurations par défaut du système d'exploitation, de MySQL et MediaWiki et avez uniquement une petite base de données (c'est-à-dire fraîchement installée), ce qui suit indique comment obtenir des recherches sur trois lettres :
 * Tout d'abord, si vous avez déjà un gros wiki, les changements prendront effet après une longue période. La référence MySQL ci-dessus a été expérimentée par quelqu'un qui avait 4 Go de base de données et cela a pris 10 jours ! Faites donc attention.

mysql> repair table searchindex quick; +++--+--+ | Table             | Op     | Msg_type | Msg_text | +++--+--+ | wikidb.searchindex | repair | status  | OK       | +++--+--+ 1 row in set (0.08 sec) mysql>
 * Le paramètre pour réinialiser est à l'intérieur de MySQL, et comme écrit ci-dessus est détaillé sur le site de MySQL. Allez là-bas pour plus de détails.
 * Trouvez le fichier de configuration pour MySQL - celui-ci est normalement my.cnf, à l'emplacement /etc
 * Éditez my.cnf et ajoutez le paramètre suivant dans le fichier (ft_min_word_len=3). Celui-ci est normalement configuré à 4 pour des raisons de performances - 4 est le nombre par défaut et n'est pas dans le fichier my.cnf lorsqu'il est installé. Soyez sûr que celui-ci est placé sous la section [mysqld] de my.cnf
 * Redémarrez MySQL, en utilisant le Service Controller ou arrêtez et redémarrez mysqld à partir de la ligne de commande
 * Allez dans MySQL (mysql dans la ligne de commande)
 * Utilisez la commande MySQL qui vous permet d'afficher la base de données du wiki (use wikidb;) - '''veuillez noter que ceci peut être différent si vous avez changé le nom par défaut de la base de données en mettant par exemple my_wikidb
 * Reconstruisez l'index de recherche en demandant à réparer la table searchindex. La ligne de commande à taper est : repair table searchindex quick; Un exemple ci-dessous montre ce que vous devez voir :
 * Retestez à partir de votre serveur wiki ce que vous obtenez maintenant - soyez sûr d'avoir de quoi trouver un mot sur votre wiki, sinon vous n'en trouverez pas !
 * L'explication ci-dessus est réalisée sous Fedora Core 4 OS, le serveur étant un Compaq ML570. Ça devrait fonctionner pour les autres distributions.

Si vous avez mis à jour MySQL depuis v 3.xx afin de faire ci-dessus, vous devez changer le paramètre suivant dans votre fichier LocalSettings.php afin que ça fonctionne.
 * Note importante

Avant : $wgDBmysql4 = false;

Après : $wgDBmysql4 = true;</tt>

Comment puis-je permettre le téléchargement ?
Les téléchargements de fichiers sont une fonctionnalité de MediaWiki souvent utilisée, mais est désactivée par défaut dans toutes les versions finales actuelles. Pour les autoriser, faites d'abord un répertoire de téléchargement (par défaut images</tt>) dans lequel le serveur web a l'autorisation d'écrire (CHMOD 777 ou permettre à l'utilisateur Apache d'écrire dans celui-ci, etc.) et ensuite configurez $wgEnableUploads à true</tt> dans votre LocalSettings.php.

Comment purger le cache d'une page
Pour purger le cache d'une page, ajoutez &action=purge</tt> à la fin de l'url de la page.

Par exemple http://www.mediawiki.org/w/index.php?title=Main_Page&action=purge

Comment puis-je permettre le téléchargement d'autres formats de fichier ?
MediaWiki demande à ce que les formats de fichier téléchargeables soient spécifiés en utilisant la directive de configuration $wgFileExtensions.

Par exemple, pour permettre de télécharger des fichiers PDF, ajoutez la ligne suivante dans LocalSettings.php :

$wgFileExtensions[] = 'pdf';

Problèmes
Quelques utilisateurs ont rapporté que, après avoir ajouté un format de fichier dans la liste des extensions autorisées, une erreur survenait. Le texte de l'erreur est similaire au suivant :


 * The file is corrupt or has an incorrect extension. Please check the file and upload again.
 * Traduction : Le fichier est corrompu ou a une extension incorrecte. Veuillez vérifier le fichier et le retélécharger à nouveau.

La solution à ceci est de vérifier la valeur de $wgMimeDetectorCommand et de la corriger si nécessaire. Par exemple, sous Unix, configurez ceci comme :

$wgMimeDetectorCommand = "file -bi";

Sinon l'extension fileinfo doit être compilée dans PHP.

Comment puis-je permettre les lettres minuscules dans les titres d'articles ?
Par défaut, MediaWiki met une majuscule à la première lettre du titre des articles. Si vous voulez désactiver ceci, vous devrez faire attention au titre des articles : Exemple n'est pas pareil que exemple.

Ajoutez la ligne suivante au LocalSettings.php : $wgCapitalLinks = true;

Comment puis-je empêcher MediaWiki d'interdire les cadres (frames / iframes / wrappers) ?
MediaWiki a un peu de code qui le protège d'être abusivement intégrés aux frames d'autres sites web. Cependant, si vous voulez le faire apparaître dans une frame, alors le code ci-dessous doit être retiré ou mis en commentaire. Il se trouve dans le fichier skins/common/wikibits.js :

// Un-trap us from framesets if( window.top != window ) window.top.location = window.location;

Important : une fois les changements faits, le cache du navigateur doit être effacé. Si le cache n'est pas effacé, le code est toujours utilisé et continuera à empêcher les frames.

Mettre à jour MediaWiki
Des instructions génériques sur le processus de mise à jour peuvent être trouvées dans le fichier UPGRADE</tt> fourni avec le logiciel. Voir aussi Manual:Upgrading.

Comment puis-je changer le logo ?
Le logo du site visible en haut à gauche de chaque page est déterminé par le préfixe de configuration $wgLogo inclus dans le fichier LocalSettings.php.

Pour choisir un autre logo, il suffit de modifier la valeur de $wgLogo pour l'adresse URL de votre propre image logo. Vous pouvez télécharger un fichier sur votre wiki et utiliser son adresse (ce qui permettra de plus facilement modifier le logo ou le protéger) ou utiliser une image téléchargée sur votre serveur par d'autres moyens.

Remarque : Il est toujours possible d'utiliser le logo par défaut de MediaWiki, mais cela est vivement non recommandé, car une modification du logiciel pourrait bloquer une modification du logo  ou de son adresse de fichier.

Astuce : l'image du logo doit avoir une taille de 135 pixels de côté.

Comment puis-je personnaliser la barre de navigation ?
Le contenu de la barre de navigation qui apparaît à gauche de chaque page (lorsqu'on utilise le skin par défaut Monobook) sont déterminées par la page MediaWiki:Sidebar. Pour plus d'information sur cette personnalisation possible, vous pouvez aller voir Manual:Navigation bar.

Comment puis-je changer la page d'accueil ?
Par défaut, MediaWiki montre une page avec le titre Main Page et donne celle-ci comme page par défaut. Ceci peut être changé en modifiant MediaWiki:Mainpage pour pointer vers un autre titre.

Comment puis-je cacher la table des matières ?
Placez le mot magique  </tt> dans le texte de la page.
 * Pour une page

Éditez le fichier CSS ; trouvez le style de la table des matières et ajoutez display:none;</tt> à sa définition.
 * Pour toutes les pages

Les utilisateurs peuvent aussi choisir de ne pas afficher leur propre table des matières. Ceci est une préférence de l'utilisateur et peut être modifiée dans Special:Preferences.
 * Par utilisateur

Comment puis-je changer le texte de l'interface ?
Depuis la version 1.5 de MediaWiki, le texte de l'interface est configurable en utilisant l'espace de nom MediaWiki. Par défaut, ces messages sont remplis par avec le texte de la langue sélectionnée pendant l'installation ou la mise à jour. Pour modifier le contenu d'un message système, éditez la page correspondante dans l'espace de nom (namespace) MediaWiki.


 * Pour avoir une liste de tous les messages système, voir Special:Allmessages
 * Pour désactiver l'espace de nom MediaWiki, voir le paramètre de configuration $wgUseDatabaseMessages.

Procédure pour modifier les messages mediawiki qui sont toujours en anglais

 * Il faut être connecté avec un compte SysOp (opérateur système). (C'est l'administrateur qui peut donner la qualité SysOp à tel ou tel utilisateur, grâce à la Page spéciale 'User rights management')
 * ouvrir le lien ‘Pages spéciales’ (à gauche) et choisir ‘Liste des messages système’…
 * Après une éventuelle recherche (CTRL + F) d’un fragment du message actuel,
 * cliquer sur le nom du message voulu (colonne de gauche) dans le tableau de tous les messages, ce qui ouvre la page du message
 * utiliser simplement l’onglet ‘modifier’ pour corriger le message…
 * Enregistrer…
 * C’est tout :o)

Si quelqu'un connaît la procédure pour faire toutes les corrections-traductions complémentaires d'un coup, avec un seul fichier, ce serait utile de décrire la procédure, merci :o)

Comment puis-je changer la langue de l'interface ?

 * 1) Changez la valeur de $wgLanguageCode dans le fichier LocalSettings.php
 * 2) Exécutez le script de maintenance rebuildMessages.php</tt> pour reconstruire l'espace de nom MediaWiki.

Comment éditer une page ?
Pour éditer une page, cliquez simplement sur le lien modifier qui apparaît sur chaque page. Lorsqu'on utilise le skin par défaut MonoBook, celui-ci est dans la liste d'onglets en haut de la page. Un formulaire apparaît, contenant le wikitexte (code source de la page) existant pour la page donnée. Lorsque vous avez fini vos modifications, cliquez sur le bouton Sauvegarder pour enregistrer vos changements. Ceux-ci apparaissent directement.

Astuce : Le bouton Prévisualiser permet de voir vos changements sans enregistrer tout de suite.

Comment créer une nouvelle page ?
Il y a plusieurs façons de créer une nouvelle page :


 * Cliquer sur un lien rouge existant ; ou s'il n'y en a pas, en créer un.
 * Aller à l'adresse de la page, par exemple http://www.foowiki.org/index.php/New_page et cliquer sur le lien modifier.

Voir Help:Starting a new page

Existe-t-il des tutoriaux à propos de l'édition ?
Il y a plusieurs tutoriaux sur l'édition, la plupart sur les projets Wikimédia, tels que Wikipédia. Il y a aussi des références de syntaxe, etc. disponibles sur Meta.


 * Aide de Meta en anglais : Editing
 * Le guide How to edit a page sur la Wikipédia anglophone
 * Le guide ''Aide:Syntaxe sur la Wikipédia francophone

Comment puis-je avoir un format imprimable de la page ?
MediaWiki inclut des feuilles de style qui donnent automatiquement un style approprié à une page pour l'impression ; en utilisant la fonction d'impression ou de prévisualisation d'impression du navigateur, celle-ci doit rendre la page dans un format imprimable.

Vous pourvez aussi voir le format imprimable en utilisant le lien Version imprimable de la boîte à outils.

Comment empêcher l'édition par les utilisateurs anonymes ?
Depuis MediaWiki 1.5, il y a eu des avancées significatives pour paramétrer facilement et de façon flexible les permissions qui permettent de donner un accès restreint à certaines fonctions. Ces permissions sont contrôlées par l'option de configuration $wgGroupPermissions.

Pour plus d'informations sur la configuration de cette option, voir la page Preventing Access sur Meta (en anglais).

Quels privilièges particuliers ont les 'bots' ?
Le mot bots est le diminutif de robot qui permet la création d'un statut particulier.

Les comptes ayant le statut de bot ne sont pas la liste des modifications récentes. Cette propriété est utilisée pour ne pas alourdir la page dans le cas de modifications automatisées, d'où l'appellation de robot.

Comment puis-je inclure un raccourci alphabétique en haut d'une page catégorie ?
Il suffit de créer un modèle modèle que vous pouvez appeller "Modèle:Sommaire alphabétique catégorie" grâce au code suivant :

Pour inclure ce modèle sur les pages de catégorie, il suffit de taper

...l'espace de nom Help de ce site est-il vide ?
Nous n'avons pas actuellement un ensemble propre et internationalisé de pages d'aide sous licence libre. Quelques développeurs espèrent rendre cela possible ; cependant l'espace de nom Help est encore en construction. Vous êtes libre d'ajouter vos propres pages, pourvu que vous acceptiez de les mettre dans le domaine public pour l'espace de nom Help (les autres pages du site qui ne sont pas dans l'espace de nom Help sont sous Licence de documentation libre GNU).

...certaines de mes images n'apparaissent pas après une mise à jour ?
Plusieurs utilisateurs ont rapporté que, après une mise à jour ou un déplacement de leur wiki, plusieurs images ne s'affichaient pas. Les fichiers existent, et la page de description de l'image montre un type MIME unknown / unknown</tt> (inconnu) et dans certains cas un avertissement concernant les fichiers potentiellement dangereux.

La solution à cela est d'exécuter le script de maintenance rebuildImages.php à partir de la ligne de commande. Cela configure les types MIME pour tous les fichiers de la base de données, et devrait rétablir les choses à la normale.

...tous les fichiers PNG ne sont pas affichés en vignette ?
Après le téléchargement d'une version plus récente de PHP, il est possible qu'une fonction MimeMagic.php soit utilisée pour détecter les types MIME, particulièrement la fonction PHP générique mime_content_type, qui échoue à détecter les fichiers PNG. Cherchez sur les web mime_content_type png pour avoir des informations sur la résolution de ce bug pour la version de PHP, peut-être en éditant votre fichier magic.mime.

...ne puis-je pas télécharger MediaWiki 1.9 ?
MediaWiki 1.9 est actuellement en développement, et n'a pas encore été mis en archive dans une version finale. Le code peut être téléchargé à partir de Subversion si vous voulez.

...ça ne marche pas ? Ça marche sur Wikipédia !
Les sites Wikimédia utilisent actuellement MediaWiki 1.9 alpha. Voir la section ci-dessus pour les avertissements et les informations pour obtenir l'obtenir.

Également, les sites fonctionnent avec plusieurs extensions, comme "Makesysop" et "Renameuser" (la liste complète existe dans la page de version de n'importe quel projets de Wikimédia.

Où puis-je obtenir l'extension anti-spam et comment puis-je l'installer ?
L'extension anti-spam des sites Wikimédia peut être trouvée dans Subversion. Pour les instructions d'installation, consultez le fichier README.

La liste utilisée par les sites Wikimédia se trouve sur Spam blacklist.

Comment puis-je utiliser $wgSpamRegex pour bloquer plus d'une chaîne de caractères ?
$wgSpamRegex est un puissant filtre pour le contenu d'une page. Ajouter plusieurs items de regex est parfois maladroit. Considérez le code suivant :

$wgSpamRegexLines[] = 'display\s*:\s*none'; $wgSpamRegexLines[] = 'overflow:\s*\s*auto'; [...] $wgSpamRegex = '/(' . implode( '|', $wgSpamRegexLines ) . ')/i';

Cet exemple de code permet d'additionner facilement des items à la regex sans trop compliquer à chaque occurence. Il montre aussi deux filtres populaires qui bloquent quelques unes des attaques de spam les plus courantes.

J'ai trouvé un bug ou ai une demande de fonctionnalité. Où puis-je poster cela ?
Les bugs et les demandes de fonctionnalités doivent être postés sur MediaZilla, notre implémentation de Bugzilla. Veuillez rechercher dans la base de données avant de poster pour éviter de créer des entrées en double.

J'ai une question dont il n'y a pas de réponse ici. Où puis-je aller ensuite ?
Si vous avez parcouru toute la FAQ ci-dessus, vous pouvez essayer les endroits suivants :


 * Vérifiez les autres sources d'aide de ce site.
 * Recherchez sur ce site.
 * Regardez notre documentation sur Meta
 * Envoyez un e-mail à la liste de diffusion mediawiki-l
 * Demandez aux développeurs sur notre canal IRC (réseau Freenode, canal #mediawiki)

Lectures conseillées

 * De la bonne manière de poser les questions (version originale en anglais : Asking smart questions)
 * Comment signaler efficacement un bug (voir aussi la version en anglais, un peu plus à jour : Effective bug reporting)