Extension:Description2

This page is a translated version of the page Extension:Description2 and the translation is 100% complete.
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
  • $wgDescriptionMaxChars
  • $wgDescriptionRemoveElements
  • $wgDescriptionAlgorithm
  • $wgEnableMetaDescriptionFunctions
Téléchargements trimestriels 47 (Ranked 87th)
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