Extension:Display Title
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.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échargements trimestriels | 51 (Ranked 82nd) |
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 dossierextensions/
.
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 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
- 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 toSkinTemplateNavigation::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
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. |