Extension:Disambiguator
Disambiguator État de la version : stable |
|
---|---|
Implémentation | Page spéciale |
Description | Permet la désignation des pages d'homonymie avec un mot magique. |
Auteur(s) | Ryan Kaldari (Kaldaridiscussion) |
Dernière version | Mises à jour constantes |
Politique de compatibilité | Versions ponctuelles alignées avec MediaWiki. Le master n'est pas compatible arrière. |
MediaWiki | 1.28+ |
PHP | 5.4+ |
Licence | Licence MIT |
Téléchargement | |
|
|
Téléchargements trimestriels | 55 (Ranked 85th) |
Utilisé par les wikis publics | 6,730 (Ranked 31st) |
Traduire l’extension Disambiguator sur translatewiki.net si elle y est disponible | |
Problèmes | Tâches ouvertes · Signaler un bogue |
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 mot magique __DISAMBIG__
(ou un de ses alias), ce qui les enregistre alors comme telles dans la base de données.
Cela permet à d'autres extensions de traiter éventuellement les pages d'homonymie comme une classe de page distincte, bien qu'elles soient toujours considérées comme des pages « normales ».
Installation
- Téléchargez et placez le(s) fichier(s) dans un répertoire appelé
Disambiguator
dans votre dossierextensions/
.
Les développeurs et les contributeurs au code doivent à la place installer l'extension à partir de Git en utilisant:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Disambiguator - Ajoutez le code suivant à la fin de votre fichier LocalSettings.php :
wfLoadExtension( 'Disambiguator' );
- Configuration requise
- Fait – Accédez à Special:Version sur votre wiki pour vérifier que l'extension a bien été installée.
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)
- $wgDisambiguatorNotifications - s'il faut avertir l'utilisateur lorsqu'il saisit un lien vers une page d'homonymie dans les éditeurs de wikitexte (la valeur par défaut est false)
Fonctionnalités
Cette extension fournit les fonctionnalités suivantes :
- Identification des pages d'homonymie grâce au mot magique __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 VisualEditor est activé, permet de marquer une page comme homonymie via l'interface des paramètres de la page.
- Si VisualEditor est activé, montre si une page est oui ou non une page d'homonymie dans l'inspecteur de liens.
- Si VisualEditor 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-dessus)
- Avertit l'utilisateur WikiEditor quand il crée un lien qui pointe sur une page d'homonymie et lui permet de le corriger.
Utilisation
Sur wiki
Une fois Disambiguator installé, la meilleure façon de l'utiliser est d'ajouter le mot magique __DISAMBIG__
à un modèle qui sera ensuite inclus dans toutes vos pages d'homonymie.
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 page_props .
Vous aurez alors deux nouvelles Pages spéciales :
- 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.
SQL
To see if an individual page is a disambiguation page, check the page_props
table for the presence of a pp_propname = 'disambiguation'
.
Pages that are not disambiguation pages will not have this pp_propname
.
The pp_value
isn't important.
SELECT page_title, pp_propname
FROM page
LEFT JOIN page_props ON pp_page = page_id AND pp_propname = 'disambiguation'
WHERE page_namespace = 0
AND page_title IN ('John', 'COVID-19') -- John is a disambiguation page on enwiki, COVID-19 is not
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
Cette extension est utilisée par au moins un des projets Wikimédia. Cela signifie probablement que l’extension est assez stable et fonctionnelle pour être utilisée sur des sites à fort trafic. Recherchez le nom de cette extension dans le CommonSettings.php de Wikimédia et dans le fichier de configuration InitialiseSettings.php pour situer les endroits où elle est installée. Une liste complète des extensions installées sur un Wiki donné peut être visualisée sur la page Special:Version de ce wiki. |
Cette extension est incluse dans les fermes de wikis ou les hôtes suivants et / ou les paquets : Cette liste ne fait pas autorité. Certaines fermes de wikis ou hôtes et / ou paquets peuvent contenir cette extension même s'ils ne sont pas listés ici. Vérifiez toujours cela avec votre ferme de wikis ou votre hôte ou votre paquet avant de confirmer. |