Extension:Display Title

This page is a translated version of the page Extension:Display Title and the translation is 100% complete.
Other languages:
Deutsch • ‎English • ‎français • ‎polski • ‎中文 • ‎日本語
Manuel des extensions MediaWiki
OOjs UI icon advanced.svg
Display Title
État de la version : stable
Implémentation Interface utilisateur:, Fonction d'analyseur
Description Utilise la propriété de page displaytitle pour le titre d'un lien de texte et celui d'une page de discussion; optionnellement affiche le titre original de la page en tant que sous-titre; et fournit une fonction d'analyseur pour récupérer la valeur de displaytitle
Auteur(s)
Dernière version 2.1.0 (2020-02-04)
Politique de compatibilité maître
MediaWiki 1.29+
PHP 5.5+
Licence Licence MIT
Téléchargement
  • $wgDisplayTitleHideSubtitle
Vérifiez la matrice des utilisations et des versions.
Problèmes Tâches ouvertes · Signalez un bogue

L'extension Display Title permet que le titre d'affichage d'une page soit utilisé comme texte du lien par défaut pour les liens de cette page - à la fois pour les liens issus des autres pages, ainsi que pour les liens à l'intérieur de la page elle même. Display Title utilise également le titre affiché d'une page comme partie du titre de sa page de discussion. Elle affiche optionnellement sur la page, son titre original en tant que sous-titre. Et fournit une fonction d'analyse syntaxique pour récupérer le titre affiché d'une page.

Cette extension se base sur la fonctionnalité du noyau de MediaWiki prenant en charge la définition du titre d'affichage d'une page, en utilisant le mot magique DISPLAYTITLE. En mettant {{DISPLAYTITLE:My Display Title}} sur une page, vous enregistrez la valeur du titre d'affichage (My Display Title dans ce cas) dans la propriété de page displaytitle de la table page_props de MediaWiki et, si configuré correctement, vous affichez cette valeur en tant que titre de page, dans la barre de titre. L'extension Display Title recherche la valeur de displaytitle dans la table page_props pour fournir la fonctionnalité.

Installation

  • Téléchargez et placez le(s) fichiers (s) dans un répertoire appelé DisplayTitle dans votre dossier extensions/.
  • Ajoutez le code suivant à la fin de votre fichier LocalSettings.php :
    wfLoadExtension( 'DisplayTitle' );
    
  • Configurez selon les besoins
  •   Fait – Accédez à Special:Version sur votre wiki pour vérifier que l'extension a bien été installée.

Paramètres de configuration

Variable de configuration Valeur par défaut Description
$wgDisplayTitleHideSubtitle false Si la valeur est false, le titre original de la page est affiché en tant que sous-titre, en-dessous de la barre du titre.

Bien que cela ne soit pas strictement nécessaire pour le fonctionnement de Display Title, pour que le mot magique {{DISPLAYTITLE:...}} puisse fonctionner comme prévu, initialisez les variables de configuration du noyau de MediaWiki ainsi :

$wgAllowDisplayTitle = true; // defaults to true
$wgRestrictDisplayTitle = false; // defaults to true

Utilisation

Liens

Le comportement de Extension:Display Title pour différents types de liens est résumé ci-dessous. La table indique la valeur affichée du texte du lien selon le cas. Dans le tableau, A représente le titre d'une page et a représente le titre d'une page avec le premier caractère du nom de la page (c'est à dire la partie après l'espace de noms - s'il y en a un) en minuscule. Notez que si une page est une redirection vers une autre page (par exemple Page A de la colonne « Page A redirige vers Page B » ci-dessous) et possède une déclaration display title, celle-ci sera ignorée par Extension:Display Title.

Page contient le lien : Page A ne redirige pas Page A redirige vers Page B
Page A n'a pas de Display Title Page A a un Display Title Z Page B n'a pas de Display Title Page B a un Display Title Y
[[A]] A Z B Y
[[a]] a
[[A | A]] A Z B Y
[[a | A]] A Z B Y
[[A | a]] a
[[a | a]] a
[[A | X]] X
[[a | X]] X

fonction d'analyse syntaxique #getdisplaytitle

La fonction d'analyseur #getdisplaytitle fournit le titre à afficher de la page passée en paramètre. Par exemple :

{{#getdisplaytitle:Book:42}}

affichera le displaytitle de la page Book:42. Pour obtenir le titre d'affichage de la page actuelle, utilisez :

{{#getdisplaytitle:{{FULLPAGENAME}}}}

Prise en charge de Lua/Scribunto

Il existe deux fonctions Lua (voir Extension:Scribunto) pour récupérer le titre d'affichage d'une page ou pour le déclarer : mw.ext.displaytitle.get() et mw.ext.displaytitle.set(). Pour les utiliser, créez une page Module:DisplayTitle contenant ce qui suit :

local p = {}

function p.set(frame)
	return mw.ext.displaytitle.set(frame.args[1])
end

function p.get(frame)
	return mw.ext.displaytitle.get(frame.args[1])
end

return p

Vous pourriez utiliser {{#invoke:DisplayTitle|set|My Display Title}} sur une page pour forcer le titre affiché de la page à My Display Title, et vous pourriez utiliser {{#invoke:DisplayTitle|get|My Page}} pour obtenir le titre affiché de la page My Page.

Redirections

Pour les pages de redirection, si la page cible possède un titre d'affichage, il sera utilisé comme titre d'affichage de la page de redirection.

Notez que cela a deux conséquences qui peuvent sembler surprenantes la première fois qu'on les rencontre. Lorsqu'une page ayant un titre affiché est renommée en laissant une redirection, alors sur la page qui indique que la redirection est valide on affiche le même texte de lien à la fois sur la page source et sur la page cible. Et sur la page Special:WhatLinksHere pour une page avec un titre d'affichage qui est la cible d'une redirection, le texte du lien de la page de redirection sera le titre d'affichage de la page cible.

Un seul niveau de redirection sera suivi.

Historique

La fonctionnalité de cette extension évolue en tant que partie de l'extension Semantic Title. Nos remerciements spéciaux vont à Van de Bugger, auteur de la version 1.0 de Semantic Title.

Display Title s'appuie sur des fonctions du noyau de MediaWiki et ne dépend pas d'autres extensions. La fonctionnalité en Display Title a été supprimée de Semantic Title, qui maintenant détient lui-seul la fonctionnalité de déclarer le titre d'affichage d'une page à partir de la propriété Semantic MediaWiki ou du champ Cargo. Néanmoins, il est recommandé que le titre affiché d'une page soit déclaré en utilisant {{DISPLAYTITLE:...}} plutôt que d'utiliser la fonctionnalité dans Semantic Title. Semantic Title est conservé pour maintenir la compatibilité arrière.

Notes de diffusion

Version 2.1
  • Test ajoutés
  • Ajout du contrôle de titre nul
Version 2.0.0
  • Compatibilité cassée avec MW 1.28 et antérieur
  • Bogues corrigés:
    • T181669: les entiers des références sont passés en tant que liens textuels
    • Bogue corrigé introduit dans la version 1.5.2 produisant des liens réflexifs enveloppés dans HtmlArmor
Version 1.5.3
  • Sur les pages de redirection, utiliser le titre d'affichage de la page cible
    • Ne suivre qu'un seul niveau de redirection
Version 1.5.2
  • Bogues corrigés :
    • T180413: Utiliser le texte des liens fourni plutôt que d'afficher le titre lorsque le texte du lien correspond au titre de la page sauf pour le premier caractère
    • T180409: Variable non définie : trouvé dans « DisplayTitleHooks.php » à la ligne 152
    • T181228: L'affichage de titres en italiques montre le HTML
Version 1.5.1
  • Problème corrigé concernant les utilisateurs connectés sur l'utilisation de l'action « info »
Version 1.5
  • Le texte qui aurait du réécraser le texte du lien était ignoré
  • Corriger le lien vers la page utilisateur dans l'entête (URLs personnelles)
Version 1.4
  • Mis à jour pour fonctionner avec MediaWiki 1.28+
Version 1.3
  • Modification des liens réflexifs pour faire en sorte que le texte affiché soit le même que celui des liens non réflexifs
Version 1.2
  • Ajout des fonctions Lua mw.ext.displaytitle.get() et mw.ext.displaytitle.get() écrites par User:Oetterer
Version 1.1
  • Ajout d'un contrôle sur le titre avec seulement un fragment pour la création du lien
Version 1.0
  • version intiale

Incompatibilités connues

  • Le paramètre de configuration $wgDisplayTitleHideSubtitle ne fonctionnera pas si vous avez également installé l'extension Semantic Breadcrumb Links à une version inférieure à la 1.5.0 . Ainsi le titre original de la page ne s'affichera pas en-dessous de la barre de titre.

Voir aussi