Extension:Disambiguator/fr

L'extension Désambiguïsateur (Disambiguator) est conçue pour rendre plus simple la gestion des pages d'homonymie lors du développement. Elle vous permet de désigner toutes les pages d'homonymie avec le __DISAMBIG__ (ou un de ses alias), ce qui les enregistre alors comme telles dans la base de données. Cela permet aux autres extensions de gérer les pages d'homonymie comme une classe séparée de pages.

Configuration
Les options de configuration suivantes peuvent être définies dans votre fichier LocalSettings.php
 * $wgDisambiguatorIndicateLinks - ajouter ou non une classe CSS 'mw-disambig' sur les liens vers les pages d'homonymie (vrai par défaut)

Fonctionnalités
Cette extension fournit les fonctionnalités suivantes :


 * Identification des pages d'homonymie grâce au __DISAMBIG__.
 * De nouvelles pages spéciales pour lister toutes les pages d'homonymie et celles qui possèdent des liens vers ces dernières.
 * De nouvelles fonctions dans l'API équivalentes aux pages spéciales ci-dessus, dont une pour savoir si une page est oui ou non une page d'homonymie.
 * Modifie Special:LonelyPages de façon à ignorer les pages d'homonymie.
 * Modifie Special:Random de façon à ignorer les pages d'homonymie (nécessite MediaWiki 1.26 ou plus)
 * Si est activé, permet de marquer une page comme homonymie via l'interface des paramètres de la page.
 * Si est activé, montre si une page est oui ou non une page d'homonymie dans l'inspecteur de liens.
 * Si est activé, montre si une page est une homonymie ou non dans le boîte de dialogue pour lien.
 * Si configuré, ajoute une classe CSS 'mw-disambig' sur les liens vers les pages d'homonymie (voir #Configuration ci-dessous)

Sur wiki
Une fois installée, la meilleure façon d'utiliser cette extension est d'ajouter la mot magique $1 à un modèle qui sera par la suite inclus dans toutes vos pages d'homonymie.

Once Disambiguator is installed, the best way to use it is to add the  magic word to a template that is then included in all of your disambiguation pages.

Par la suite, une fois le mot magique en place, vos pages d'homonymie auront une propriété assignée dans la base de données pour indiquer que ce sont des pages d'homonymie. Cette propriété réside dans la table.

Vous aurez alors deux nouvelles :
 * Special:DisambiguationPages - qui liste toutes les pages d'homonymie de votre wiki.
 * Special:DisambiguationPageLinks - qui liste toutes les pages de votre wiki qui possèdent des liens vers des pages d'homonymie. (Il s'agit d'un remplaçant de l'ancienne page Special:Disambiguations qui est désormais obsolète.)

Avec l'API
Pour lister toutes les pages d'homonymie :

api.php?action=query&list=querypage&qppage=DisambiguationPages

Pour lister tous les liens vers une page d'homonymie :

api.php?action=query&list=querypage&qppage=DisambiguationPageLinks

À noter que pour les wikis utilisant le « MiserMode » (dont tous les wikis de la Fondation Wikimedia), à la fois la page spéciale et le module de l'API pour les liens vers des pages d'homonymie sont limités à un certain nombre de résultats (souvent entre 1 000 et 5 000).

Pour vérifier si une page est une page d'homonymie :

api.php?action=query&titles=Bug&prop=pageprops&ppprop=disambiguation

S'il s'agit d'une page d'homonymie, la clé « disambiguation » sera incluse dans les « pageprops » (propriétés de la page). Cette clé « disambiguation », si présente, aura sa valeur définie à une chaîne de caractères vide, soyez donc prudent si vous souhaitez la transformer en booléen.

Plans possibles pour l'avenir

 * Ajouter une option pour masquer des pages d'homonymie sur : Special:AllPages (task #9936), Special:PrefixIndex (task #11319), Special:WhatLinksHere (task #9935), Special:AncientPages (task #76287)
 * Considérer que l'on étend le dialogue du lien dan s l'éditeur de texte wiki avec la possibilité de détecter les ambigüités dans les resultats de recherche et d'extraire une liste de liens
 * Liste complète des bogues de cette extension