Modèle:Titre incorrect/Documentation

Ceci est la page de documentation du modèle {{Titre incorrect}}.
Cette page n’est pas destinée à être visualisée directement. Les liens utilisant des pseudo-variables peuvent paraître rompus (en rouge) ; ne pas les remplacer par des noms de pages codés en dur ni des URL.

Ce modèle modifie le titre visible rendu par MediaWiki.

Utilisation

Ce modèle est utilisé lorsque MediaWiki est incapable de restituer le véritable titre à l’article ou des incertitudes orthographiques ou de codage conduisent à y substituer certains caractères. (par exemple, la première lettre doit être en minuscule ; présence d’un caractère non autorisé ; etc.)

Syntaxe de base

{{Titre incorrect | 1=Titre réel corrigé}}

La numérotation explicite du paramètre (« 1=... ») est nécessaire lorsque le titre corrigé contient le symbole « = ».

Paramètres supplémentaires

Le modèle supporte les paramètres supplémentaires suivants :

• 2=explication : Affiche une explication supplémentaire dans le bandeau lorsqu'il est affiché.
• invisible=n'importe quoi N'affiche pas le bandeau d'avertissement, même lorsque le titre corrigé n'a pas pu être restitué (par exemple lorsque JavaScript est désactivé). Cette option est utile lorsque la correction est uniquement de type cosmétique.
• nocorr=n'importe quoi Désactive la correction par défaut du titre et le masquage du bandeau par JavaScript. Cette fonctionnalité n'est pas disponible si la correction du titre consiste seulement à mettre la première lettre en minuscule.

Exemples

Le code « {{titre incorrect | 1=XX{{e}} siècle | 2=L'indicateur d'ordinal « e » devrait être en exposant. | nocorr=nocorr}} » affiche le bandeau :

Titre correct : « XXe siècle » En raison de limitations techniques, la typographie souhaitable du titre n’a pu être restituée correctement. L'indicateur d'ordinal « er » devrait être en exposant.

Le bandeau reste visible et le titre de cette page n'est pas corrigé à cause du paramètre nocorr

Le code « {{titre incorrect | 1=Clotaire {{Ier}} | invisible=oui}} » n'affiche pas de bandeau, mais le titre de la page est corrigé si JavaScript est activé.

Fonctionnement

Si la correction du titre consiste juste à mettre la première lettre en minuscule, le modèle utilise le mot magique {{DISPLAYTITLE:}} pour afficher le titre correct. Sinon, le titre correct est substitué à l’aide d’une fonction JavaScript (sauf en cas d'utilisation du paramètre « nocorr »). Sur les navigateurs n’ayant pas le JavaScript activé, un bandeau est affiché avertissant de l’orthographe correcte (sauf en cas d'utilisation du paramètre « invisible »).

Informations techniques

Le script JavaScript responsable de la correction du titre se trouve dans MediaWiki:Common.js ; il s'agit de la méthode rewritePageH1(), laquelle, au chargement de la page,

• détecte la présence du bandeau, identifiable par id="RealTitleBanner" ;
• vérifie si un élément de la page a un attribut id="DisableRealTitle" (un tel attribut est ajouté en cas d'utilisation du paramètre nocorr, mais il peut aussi être ajouté manuellement). Si tel est le cas le script s'arrête ici ;
• récupère le titre réel corrigé, identifié par id="RealTitle" ;
• utilise son contenu pour remplacer le titre du premier élément <h1> de la page ;
• masque enfin le bandeau trouvé.

Ce comportement est effectif dès que des éléments avec attributs id="RealTitleBanner" et id="RealTitle" sont présents, ce qui permet d'en tirer parti sans passer nécessairement par un appel à {{titre incorrect}}.