Extension:Display Title

From mediawiki.org
This page is a translated version of the page Extension:Display Title and the translation is 88% complete.
Outdated translations are marked like this.
Manuel des extensions MediaWiki
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 4.0.2 (2023-07-26)
Politique de compatibilité Versions ponctuelles alignées avec MediaWiki. Le master n'est pas compatible arrière.
MediaWiki 1.39+
PHP 7.4+
Composer mediawiki/display-title
Licence Licence MIT
Téléchargement
  • $wgDisplayTitleFollowRedirects
  • $wgDisplayTitleExcludes
  • $wgDisplayTitleHideSubtitle
Téléchargements trimestriels 63 (Ranked 89th)
Traduire l’extension Display Title
Problèmes Tâches ouvertes · Signaler 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) fichier(s) dans un répertoire appelé DisplayTitle 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/DisplayTitle
  • Ajoutez le code suivant à la fin de votre fichier LocalSettings.php  :
    wfLoadExtension( 'DisplayTitle' );
    
  • Configurer si nécessaire.
  • Yes Fait – Accédez à Special:Version sur votre wiki pour vérifier que l'extension a bien été installée.

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.
$wgDisplayTitleExcludes [ ] Un tableau de noms de pages pour lesquelles le nom de page ne doit pas être remplacé par leur titre d'affichage dans les liens vers ces pages.
$wgDisplayTitleFollowRedirects true Indique si les redirections doivent être suivies pour afficher le 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

Afficher le titre sur les pages et les liens de modification

Pour que Display Title soit utilisable sur les pages de modification et les liens vers elles, modifiez les messages système suivants sur votre wiki (en substituant la langue locale du wiki où c'est nécessaire) :

Nom de la page du message système Ancien contenu de la page Nouveau contenu de la page
MediaWiki:Editing Editing $1 Editing {{#if: {{NAMESPACE}} | {{NAMESPACE}}: |}}{{#getdisplaytitle:{{SUBJECTPAGENAME}}}}
MediaWiki:Editingcomment Editing $1 (new section) Editing {{#if: {{NAMESPACE}} | {{NAMESPACE}}: |}}{{#getdisplaytitle:{{SUBJECTPAGENAME}}}} (new section)
MediaWiki:Editingsection Editing $1 (section) Editing {{#if: {{NAMESPACE}} | {{NAMESPACE}}: |}}{{#getdisplaytitle:{{SUBJECTPAGENAME}}}} (section)
MediaWiki:Editsectionhint Edit section: $1 Edit section: {{#if: {{NAMESPACE}} | {{NAMESPACE}}: |}}{{#getdisplaytitle:{{SUBJECTPAGENAME}}}}
MediaWiki:Creating Creating $1 Creating {{#if:{{NAMESPACE}}|{{NAMESPACE}}:}} {{#getdisplaytitle: {{SUBJECTPAGENAME}} }}

Et si vous utilisez aussi Page Forms.

Nom de la page du message système Ancien contenu de la page Nouveau contenu de la page
MediaWiki:Pf formedit createtitle Create $1: $2 Create $1: {{#if:{{NAMESPACE}}|{{NAMESPACE}}:}} {{#getdisplaytitle: {{SUBJECTPAGENAME}} }}
MediaWiki:Pf formedit edittitle Edit $1: $2 Edit $1: {{#if:{{NAMESPACE}}|{{NAMESPACE}}:}} {{#getdisplaytitle: {{SUBJECTPAGENAME}} }}

Utilisation

Liens

Le comportement de l'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 qu'elle possède une déclaration display title, celle-ci sera ignorée par cette extension.

La page source contient le lien : La page A ne redirige pas La page A redirige vers la page B
La page A n'a pas Display Title La page A a Display Title Z La page B n'a pas Display Title La page B a 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

<span id="#getdisplaytitle_parser_function">

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 4.0.2
Version 4.0.1
  • Fix title handling in hooks (T342672)
  • Revert user preference to disable the extension due to a bug (T342727) and since the current approach introduces latency and risk
Version 4.0.0
  • Drop support for MediaWiki 1.38 and earlier
  • Add mw-displaytitle-subtitle class to subtitle (T205250)
  • Fix subpage subtitles for subpages more than two levels deep (T188872)
  • Fix redirect subtitle so it does not use the displaytitle (T306459)
  • Add name and description properties to composer.json (T311321)
  • Add a user preference to disable the extension (T217179)
  • Coding style and test improvements
Version 3.3
  • Do not remove fragments if not proper part of text
  • Change PersonalUrls hook to SkinTemplateNavigation::Universal hook
  • Replace deprecated WikiPage::factory/Use WikiPageFactory
Version 3.2
  • Add config option for changing redirect display ($wgDisplayTitleFollowRedirects)
  • Replace deprecated PageProps::getInstance
Version 3.1
  • Fix incompatibility with the Cite extension
Version 3.0
  • Several fixes to anchor/fragment behavior
  • Updates due to code deprecations in MediaWiki
  • Compatibility dropped with MW 1.34 and lower
Version 2.2.0
  • Ajouter le tableau $wgDisplayTitleExcludes pour définir une liste de pages pour lesquelles les liens ne doivent pas utiliser DisplayTitle
  • Corriger le comportement quand il y a des caractères souligné '_' dans le texte du lien
  • Ne pas utiliser l'accroche obsolète ParserBeforeStrip
Version 2.1.0
  • Tests 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