Module:Méta palette/Documentation

La documentation pour ce module peut être créée à Module:Méta palette/Documentation/doc

Erreur de script : Erreur Lua à la ligne 1 : '=' expected near 'utiles'.

Fonctions utiles pour les méta palettes de navigation, actuellement seulement le support des redirections.

== Liens internes ==

Tout le monde connaît les liens internes : il suffit de cliquer dessus pour arriver sur l'article désiré.

Ce qui est bon à savoir, c'est qu'un lien interne s'affiche généralement en bleu mais que si la cible du lien est identique à l'article affiché, le lien s'affiche en '''noir gras'''<ref name=noirgras>en blanc gras en mode sombre.</ref> et ressort donc bien à la lecture.

== Redirections ==

Une redirection est une page qui redirige vers un autre article, la cible de la redirection. Dans un article, une redirection s'affiche en bleu comme un lien normal ; il suffit de cliquer dessus pour arriver sur l'article cible de la redirection.

Ce qui est bon à savoir, c'est que le lien d'une redirection n'est jamais identique à l'article affiché. Le lien s'affichera donc toujours en bleu et jamais en noir gras<ref name=noirgras/>, même si la cible de la redirection est identique à l'article affiché.

== Palettes ==

Les palettes sont des modèles contenant une collection de liens internes et prévues pour être incluses dans plusieurs articles. Par exemple, la [[Modèle:Palette Président de la République française|Palette Président de la République française]] reprend la liste des présidents de la République française, et elle est incluse en bas de l'article de chacun des présidents. Ce qu'il y a de bien, c'est que dans l'article sur [[Raymond Poincaré]] par exemple, le nom de '''Raymond Poincaré''' apparaîtra en noir gras<ref name=noirgras/> dans la palette en bas de la page, ce qui permet de le situer rapidement dans la liste des présidents français.

Le problème, c'est que le lien reste bel et bien en bleu au lieu d'apparaître en noir gras<ref name=noirgras/> si la palette contient une redirection au lieu de contenir un lien vers l'article lui-même. C'est pour cela qu'il existe une [[Aide:Palette#REDIRECTIONS|recommandation]] qui préconise d'éviter les redirections dans les palettes.

== Méta palettes ==

Supposons qu'on veuille une palette avec la liste de tous les pays d'Afrique, puis une autre palette avec la liste des gouvernements des pays d'Afrique, une autre avec la culture, la musique, etc. Au lieu de recopier la liste de tous les pays d'Afrique dans chacune de ces palettes (bonjour les erreurs et la maintenance), on crée une méta palette, par exemple la {{m|Méta palette de navigation Afrique}} : on lui donne le préfixe que l'on désire, par exemple gouvernement, culture ou musique, et la méta palette génère la liste de tous les articles avec ce préfixe pour tous les pays d'Afrique. Il suffit donc de créer les palettes désirées en se contentant d'appeler la méta palette : <code><nowiki>{{Méta palette de navigation Afrique|préfixe=Culture}}</nowiki></code>.

Le problème, c'est qu'une méta palette exige une convention très stricte sur les titres des articles. Par exemple la méta palette exigera un titre ''Culture du Maroc'', ce qui coince si l'article s'intitule ''Culture marocaine''. Utiliser une redirection de ''Culture du Maroc'' vers ''Culture marocaine'' n'est pas une solution valable puisqu'une redirection apparaîtra toujours comme un lien bleu alors que le titre ''Culture du Maroc'' devrait apparaître en noir gras<ref name=noirgras/> dans l'article ''Culture marocaine''.

La solution est de « détourner » le lien dans la palette qui appelle la méta-palette : au lieu d'écrire simplement <code><nowiki>{{Méta palette de navigation Afrique|préfixe=Culture}}</nowiki></code> on écrira plutôt <code><nowiki>{{Méta palette de navigation Afrique|préfixe=Culture|Culture du Maroc=Culture marocaine}}</nowiki></code> pour indiquer qu'on détourne le lien ''Culture du Maroc'' demandé par la méta palette vers l'article ''Culture marocaine'' qui est l'article réel. La méta palette générera alors religieusement un lien vers ''Culture marocaine'', qui apparaîtra donc en noir gras<ref name=noirgras/> dans cet article.

== Mode d'emploi ==

=== Détournement dans les palettes ===

<!--
    Ne pas modifier le titre de cette section, il est utilisé dans beaucoup de liens.
-->

Dans les palettes appelant une méta palette, par exemple {{m|Palette Culture en Afrique}}, repérer les cas où la méta palette utilise une redirection. Si par exemple, la méta palette génère un lien <nowiki>[[Culture de l'Égypte]]</nowiki> qui est en fait une redirection vers l'article <nowiki>[[Culture égyptienne]]</nowiki>, il suffit de « détourner » le lien <nowiki>[[Culture de l'Égypte]]</nowiki> vers <nowiki>[[Culture égyptienne]]</nowiki> en le disant à la méta palette avec <code><nowiki>{{Méta palette de navigation Afrique | préfixe = Culture | Culture de l'Égypte = Culture égyptienne}}</nowiki></code>. La méta palette génèrera alors le bon lien, qui apparaîtra en '''noir gras'''<ref name=noirgras/> dans l'article [[Culture égyptienne]].

Inutile d'essayer de reproduire exactement le lien généré par la méta palette, avec tous ses blancs soulignés et ses espaces insécables. Le mieux est de cliquer sur le lien et de copier/coller le texte affiché. Par exemple dans « (Redirigé depuis XXX) » il suffit de copier/collet le XXX. Le module comprendra.

=== Support dans les méta palettes ===

Un support est nécessaire de la part des méta palettes. Il n'est pas nécessaire ni possible de supporter tous les paramètres additionnels ; il suffit d'utiliser le [[Module:Méta palette]] pour générer les liens, et le module s'occupera du reste. Par exemple, au lieu d'écrire <code><nowiki>[[Cuisine de l'Égypte|Égypte]]</nowiki></code> la méta palette doit écrire <code><nowiki>{{#invoke:Méta palette|Cuisine de l'Égypte|Égypte}}</nowiki></code>

=== Module Méta palette ===

Le [[Module:Méta palette]] offre un support aux méta palettes. Il ne contient actuellement qu'une seule fonction, lien.

=== Fonction « lien » ===

Cette fonction du [[Module:Méta palette]] n'est utilisée que par les méta palettes. Elle formate un lien interne.

Paramètres :
* ''lien'' : lien de l'article désiré ;
* ''texte'' : texte à afficher.

Cette fonction formate un lien interne, en utilisant comme cible du lien
la valeur du premier paramètre et comme texte affiché la valeur du second
paramètre. Si le modèle contenant le #invoke (c'est à dire la méta palette)
avait été appelé (donc par la palette) avec un
paramètre portant le même nom que la valeur du premier paramètre passé au
module, alors le module utilisera la valeur du paramètre du modèle comme
cible du lien, ce qui permet de détourner le lien.

Par exemple, si le modèle contient
<code><nowiki>{{#invoke:Méta palette|lien|cible-1|texte-1}}</nowiki></code>
et que le modèle est appelé avec
<code><nowiki>{{Modèle}}</nowiki></code>
alors le lien généré sera
<code><nowiki>[[cible-1|texte-1]]</nowiki></code>.

Mais si le même modèle est appelé avec
<code><nowiki>{{Modèle|cible-1=toto}}</nowiki></code>
alors le lien généré sera
<code><nowiki>[[toto|texte-1]]</nowiki></code>.