Extension:Display Title

**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)	Cindy Cicalese discussion; Tobias Oetterer discussion;
Dernière version	4.0.3 (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	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 $wgDisplayTitleFollowRedirects; $wgDisplayTitleExcludes; $wgDisplayTitleHideSubtitle;
	Accroches utilisées BeforePageDisplay; HtmlPageLinkRendererBegin; OutputPageParserOutput; ParserFirstCallInit; ScribuntoExternalLibraries; SelfLinkBegin; SkinTemplateNavigation::Universal;
Téléchargements trimestriels	58 (Ranked 82nd)
	Traduire l’extension Display Title
Problèmes	Tâches ouvertes · Signaler un bogue

This page is a translated version of the page Extension:Display Title and the translation is 88% complete.

Outdated translations are marked like this.

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.
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 {{phpi|true}}
$wgRestrictDisplayTitle = false; // defaults to {{phpi|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 source contient le lien :	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

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

Fix Lua class name (T343929)

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

mot magique DISPLAYTITLE

Cette extension est incluse dans les fermes de wikis ou les hôtes suivants et / ou les paquets :

Cette liste ne fait pas autorité. Certaines fermes de wikis ou hôtes et / ou paquets peuvent contenir cette extension même s'ils ne sont pas listés ici. Vérifiez toujours cela avec votre ferme de wikis ou votre hôte ou votre paquet avant de confirmer.

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)	Cindy Cicalese ^discussion Tobias Oetterer ^discussion
Dernière version	4.0.3 (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	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 $wgDisplayTitleFollowRedirects $wgDisplayTitleExcludes $wgDisplayTitleHideSubtitle
Accroches utilisées BeforePageDisplay HtmlPageLinkRendererBegin OutputPageParserOutput ParserFirstCallInit ScribuntoExternalLibraries SelfLinkBegin SkinTemplateNavigation::Universal
Téléchargements trimestriels	58 (Ranked 82^nd)
Traduire l’extension Display Title
Problèmes	Tâches ouvertes · Signaler un bogue