Extension:Description2

From mediawiki.org
Jump to navigation Jump to search
This page is a translated version of the page Extension:Description2 and the translation is 59% complete.
Other languages:
Manuel des extensions MediaWiki
OOjs UI icon advanced-invert.svg
Description2
État de la version : stable
Implémentation Extraction de données, Extension de l'analyseur
Description Fournit une balise meta 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 (2017-11-02)
Politique de compatibilité Le master conserve la compatibilité arrière.
MediaWiki 1.25+
Modifie la base
de données
Non
Licence Licence publique générale GNU v2.0 ou supérieur
Téléchargement
  • $wgEnableMetaDescriptionFunctions
Traduire l’extension Description2 sur translatewiki.net si elle y est disponible

Vérifier la matrice des utilisations et des versions.

L'extension Description2 ajoute une balise meta 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 les informations de description erronées du wiki et utilisera quelque chose comme le sitenotice comme description d'une page au lieu de son contenu. Cette extension ajoute également la description à la sortie de l'analyseur d'une manière que d'autres extensions peuvent utiliser (pour dire fournir une 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) fichiers (s) dans un répertoire appelé Description2 dans votre dossier extensions/.
  • Ajoutez le code suivant à la fin de votre fichier LocalSettings.php :
    wfLoadExtension( 'Description2' );
    $wgEnableMetaDescriptionFunctions = true;
    
  • Yes Fait – Accédez à Special:Version sur votre wiki pour vérifier que l'extension a bien été installée.

Pour les utilisateurs de MediaWiki 1.29 ou précédents :

Les instructions ci-dessus décrivent la nouvelle procédure pour installer cette extension en utilisant wfLoadExtension(). Si vous avez besoin d'installer cette extension sur les précédentes versions de MediaWiki (1.29 ou antérieur), à la place de wfLoadExtension( 'Description2' );, vous devez utiliser :

require_once "$IP/extensions/Description2/Description2.php";

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 ces 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

Description is extracted from the HTML representation of a page:

  1. Remove all ‎<table> elements (and its contents).
  2. Find all ‎<p> elements.
  3. Iterate over those paragraphs, stripping out all HTML tags and trimming whitespace around it.
  4. The first non-empty paragraph (after all previous transformation) is picked as the description.

Things to consider:

  • When using templates at the top of the articles, if you use ‎<div> instead of tables for the template, be sure it doesn't render paragraphs, which otherwise will be used as the description. This may happen if you have several ‎<div> inside the template with newlines.

Voir aussi