Extension:Description2

Manuel des extensions MediaWiki

Description2 État de la version : stable
Implémentation	Extraction de données, Extension de l'analyseur
Description	Fournit une balise meta de description et ajoute des données à la sortie de l'analyseur pour que d'autres extensions puissent les utiliser.
Auteur(s)	Daniel Friesen (Dantmandiscussion)
Dernière version	0.4.1
Politique de compatibilité	Le master conserve la compatibilité arrière.
MediaWiki	>= 1.38.0
Modifie la base de données	Non
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 $wgDescriptionMaxChars $wgDescriptionRemoveElements $wgDescriptionAlgorithm $wgEnableMetaDescriptionFunctions
Accroches utilisées OutputPageParserOutput ParserAfterTidy ParserFirstCallInit
Téléchargements trimestriels	46 (Ranked 90th)
Traduire l’extension Description2 sur translatewiki.net si elle y est disponible

L'extension Description2 ajoute une balise meta de description pour les articles automatiquement en fonction du contenu. Cette fonctionnalité semble avoir été supprimée de MediaWiki à un moment donné. Dans certaines situations, l'extraction de descriptions (par des entités moins sophistiquées que Google, comme Facebook) extraira des informations de description erronées du wiki en utilisant pour la description d'une page quelque chose comme la sitenotice au lieu de son contenu. Cette extension ajoute également la description à la sortie de l'analyseur de manière à ce que d'autres extensions puissent l'utiliser (pour dire de fournir la description dans un format différent, comme le fait Extension:OpenGraphMeta , ou peut-être pour l'utiliser dans les listes d'articles sur le wiki).

Installation

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

  wfLoadExtension( 'Description2' );
  $wgEnableMetaDescriptionFunctions = true;
  

•  Fait – Accédez à Special:Version sur votre wiki pour vérifier que l'extension a bien été installée.

Options supplémentaires

Si vous définissez $wgEnableMetaDescriptionFunctions = true; dans votre LocalSettings.php, une fonction d'analyseur de {{#description2:}} peut être utilisée pour contrôler la description générée pour la page et la remplacer par une description personnalisée. Vous pouvez utiliser les extensions d'analyseur comme ceci :

{{#description2:This is a description}}

Vous pouvez utiliser la fonction d'analyseur description2 à la place pour fournir une balise de description que vous pouvez contrôler avec les variables d'un modèle.

Algorithme

La description est extraite de la représentation HTML d'une page :

1. Supprimer tous les éléments ‎<table> (et leur contenu).
2. Chercher tous les éléments ‎<p>.
3. Réitérer sur ces paragraphes, enlever toutes les balises HTML (voir strip_tags()) en supprimant les caractères blancs qui les entourent.
4. Le premier paragraphe non vide (après toutes les transformations précédentes) est choisi pour être la description.

Eléments à considérer :

• Lorsque les modèles sont utilisés au début des articles, si vous utilisez ‎<div> au lieu des tables pour le modèle, assurez-vous qu'il ne génère pas de paragraphes qui serviraient de description. Ceci peut arriver s'il y a plusieurs ‎<div> dans le modèle avec des retours à la ligne.

Voir aussi

• Extension:OpenGraphMeta – utilise les informations de la description de Description2 quand celui-ci est installé.
• Extension:MetaDescriptionTag
• Extension:Semantic Meta Tags