Extension:Cognate

Manuel des extensions MediaWiki

Cognate État de la version : stable
Implémentation	Base de données
Description	Link different language versions of a page by using the page title.
Auteur(s)	Gabriel Birke, Addshore
Dernière version	Continuous updates
Politique de compatibilité	Versions ponctuelles alignées avec MediaWiki. Le master n'est pas compatible arrière.
MediaWiki	1.29+
Modifie la base de données	Oui
Tables	cognate_sites cognate_pages cognate_titles
Licence	Licence publique générale GNU v2.0 ou supérieur
Téléchargement	Télécharger l'extension Git [?]: Télécharger la branche master de Git parcourir le dépôt (GitHub) historique des validations (commits) contributeurs du dépôt (GitHub) relecture du code
Paramètres $wgCognateNamespaces $wgCognateReadOnly
Accroches utilisées ArticleUndelete ContentAlterParserOutput LoadExtensionSchemaUpdates PageMoveComplete PageSaveComplete WikiPageDeletionUpdates
Téléchargements trimestriels	1 (Ranked 135th)
Traduire l’extension Cognate sur translatewiki.net si elle y est disponible
Problèmes	Tâches ouvertes · Signaler un bogue

L’extension Cognate crée un espace de stockage central pour les titres des pages d’un ensemble de sites. L’extension génère alors des liens interwikis entre les wikis lorsque les titres des pages sont identiques. Elle a été développée pour résoudre la tâche « Centraliser les liens interlangues pour le Wiktionnaire ».

Le « cognat » (cognate en anglais) est un concept linguistique désignant des mots identiques dans différentes langues, développés depuis la même origine. Cela signifie que cette extension est mal nommée parce qu’elle relie des pages ayant le même titre à travers les différents wikis, un nom plus adapté serait « Homonyme » (homograph en anglais).

Pré-requis et restrictions

• Les pages doivent être dans l’un des espaces de noms standards de MediaWiki.
• Les titres des pages sont les mêmes d’une langue à l’autre (une normalisation simple sera appliquée).
• Les sites doivent avoir la même structure interwiki pour les liens interlangues.
• Les pages ne doivent contenir aucun lien interlangue dans le wikitexte, car ils prendront alors l’ascendant sur les liens automatiques de Cognate.
• Des conflits de hachage inattendus peuvent subvenir, il peut alors y avoir des liens interlangue erronés.

Comment cela fonctionne

Normalisation des titres

Une normalisation des titres très simple (réduction de certaines variantes typographiques de caractères en leurs variantes ASCII) sera effectuée par l’extension. Cela est détaillé dans la classe StringNormalizer.

La normalisation effectuée est basique. Il est possible de demander d’autres opérations, qui seront ajoutées au cas par cas.

Chaîne	Normalisée	Notes
Hello…	Hello...	La chaîne brute contient un caractère points de suspensions. Cela est normalisé en trois caractères points.
lepelle’	lepelle'	La chaîne de caractères normalisée contient une apostrophe droite.

Hachage des titres

Les titres sont hachés en utilisant SHA256. Cela est détaillé dans la classe StringHasher.

Une partie du hachage est stockée dans la base de données dans un champ entier signé de 64 bits (BIG_INT) pour faciliter les recherches.

Il y a 2⁶⁴ = 18 446 744 073 709 551 615 valeurs possibles, soit approximativement 19 chiffres décimaux et un signe.

Chaîne	Hachage	Entier
A	559AEAD08264D5795D3909718CDD05ABD49572E84FE55590EEF31A88A08FDFFD	6168500820899059065
Foo	1CBEC737F863E4922CEE63CC2EBBFAAFCD1CFF8B790D8CFD2E6A5D550B648AFA	2071311921841431698
1234567890	C775E7B757EDE630CD0AA1113BD102661AB38829CA52A6422AB782862F268646	-4074095513246505424

Hachages correspondants

Comme les titres qui nécessitent des liens sont supposés être les mêmes après normalisation, ils auront le même hachage et donc la même variable stockée dans la base de données.

Un échantillon de données peut ressembler à ce qui suit lorsque que l’on charge la page « Foo... » du Wiktionnaire en anglais.

Wiki	Titre	Entier de hachage	Entier de hachage normalisé	Notes
enwiktionary	Foo...	395730596998145766	395730596998145766	Ligne correspondante
frwiktionary	Foo…	-7435652355441782233	395730596998145766	Ligne correspondante, même quand le titre avant normalisation inclut le caractère points de suspension.
dewiktionary	Foo...	395730596998145766	395730596998145766	Ligne correspondante
arwiktionary	Foo	2071311921841431698	2071311921841431698

Écrasement des liens

Il est possible d’écraser les liens automatiques générés par Cognate, simplement en ajoutant un ou plusieurs liens interwikis dans la page.

Cela signifie également que pour faire fonctionner Cognate lorsque l’extension est déployée, les pages ne doivent contenir aucun autre lien interlangue dans leur wikicode.

Test

L’extension peut être testée sur les sites bêta du Wiktionnaire :

• https://en.wiktionary.beta.wmflabs.org/wiki/Wiktionary:Main_Page
• https://de.wiktionary.beta.wmflabs.org/wiki/Hauptseite
• https://he.wiktionary.beta.wmflabs.org/wiki/%D7%A2%D7%9E%D7%95%D7%93_%D7%A8%D7%90%D7%A9%D7%99

Ces sites sont reliés en utilisant l’extension Cognate, ainsi que l’extension InterwikiSorting qui trie les liens interwikis.

Installation

• Téléchargez et placez le(s) fichier(s) dans un répertoire appelé Cognate dans votre dossier extensions/.
  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/Cognate
• Ajoutez le code suivant à la fin de votre fichier LocalSettings.php  :

  wfLoadExtension( 'Cognate' );
  # Settings used in WMF production
  # Use the external cluster 'extension1' and dbname 'cognate_wiktionary'
  $wgCognateDb = 'cognate_wiktionary';
  $wgCognateCluster = 'extension1';
  # Only work on the main namespace
  $wgCognateNamespaces = [ 0 ];
  

• Exécutez le script de mise à jour qui va créer automatiquement les tables de base de données dont cette extension a besoin.
•  Fait – Accédez à Special:Version sur votre wiki pour vérifier que l'extension a bien été installée.

• Remplir le tableau des sites en lançant le script de maintenance populateCognateSites.php. Les sites doivent déjà exister dans le tableau des sites MediaWiki avec les groupements corrects.

php ./maintenance/populateCognateSites.php --site-group=wiktionary

• Remplir les tableaux des pages et titres en lançant le script de maintenance populateCognatePages.php.

php ./maintenance/populateCognatePages.php