Modèle:Méta bandeau d’avertissement/Documentation

Documentation du modèle

Ceci est la page de documentation de Modèle:Méta bandeau d’avertissement. [rafraîchir] · [modifier] · [historique]

Ce modèle est utilisé dans d’autres modèles pour construire des bandeaux d’avertissement. Il n’est pas destiné à être utilisé directement dans les articles.

Syntaxe

{{Méta bandeau d’avertissement
| niveau = grave, modéré, ébauche, ou information (obligatoire)
| icône = nom de l’image (facultatif)
| titre = titre de l’avertissement (obligatoire)
| texte = texte de l’avertissement (facultatif)
}}

D’autre part, le paramètre icône peut être remplacé par un paramètre icône-complexe, et des paramètres id et supplément peuvent être ajoutés.

Explication des paramètres

Paramètre « niveau »

Type de bandeau. Voici quelques indications pour choisir le niveau :

niveau « grave »

Nécessité de modification urgente, violation manifeste d’un principe fondateur (non neutralité de point de vue, etc.), ou d’une convention (travail inédit, etc.), disparition prochaine possible de contenu (violation de droit d’auteur, proposition de suppression, etc.)

niveau « modéré »

Besoin de modification de l’article (à internationaliser, etc.), annonce de travail en cours (traduction, etc.). (Les avertissements permanents sont exclus.)

niveau « ébauche »

Bandeaux d’ébauche. Un tel paramètre devrait être utilisé uniquement par le modèle {{ébauche}}. Par défaut, le style est le même que pour les bandeaux de niveau « information ».

niveau « information »

Avertissements permanents, y compris les avertissements d’évènements récents ou futurs. (Les bandeaux de maintenance, les annonces de travaux, etc. sont exclus.)

Paramètres « icône »

Nom d’une image (sans le préfixe « Image: ») à faire apparaître à gauche du bandeau en guise d’icône. Pour raison d’uniformité de style, la taille ne peut pas être spécifiée : ce sera la plus grande taille qui permette d’insérer l’image dans un rectangle de 45 pixels de large et 35 pixels de hauteur. Préférer une icône graphiquement simple et significative. En l’absence de ce paramètre, une icône par défaut dépendant du niveau est fournie.

Par exemple, les icônes des collections OOUI et Elegant Themes Circle conviennent particulièrement bien du point de vue graphique.

Paramètres « titre » et « texte »

Titre et texte explicatif du bandeau. Idéalement, le titre doit être court et significatif (maximum une ligne), et le texte ou sous-titre doit être bref, en un seul paragraphe. Ne pas enrober le message dans une prose inutilement longue. Limiter les liens aux liens les plus pertinents.

Paramètres supplémentaires : « icône-complexe », « id » et « supplément »

icône-complexe: À utiliser à la place du paramètre icône, pour remplacer l’image par du contenu quelconque. Par exemple, le modèle {{ébauche}} pourrait utiliser un tel paramètre pour afficher plusieurs icônes lorsque plusieurs thèmes lui sont fournis. À utiliser avec parcimonie.

id: Affecte un identificateur au bandeau (correspond à l’attribut « id » en HTML). Par exemple, le bandeau {{titre incorrect}} pourrait utiliser « id = RealTitleBanner » (voir la documentation de ce modèle pour en comprendre l’utilité).

supplément: Contenu supplémentaire à afficher en dessous du contenu du bandeau proprement dit. Par exemple, le bandeau {{fusionner ?}} pourrait utiliser un tel paramètre pour afficher la marche à suivre dans une section rétractable. L’icône du bandeau sera centrée sur le contenu fourni par les paramètres « titre » et « texte », sans tenir compte du contenu fourni par le paramètre « supplément ».

Exemples d’utilisation

Avec le paramètre « icône »

Code

Rendu

{{Méta bandeau d’avertissement
|niveau=modéré
|icône=Under construction red.svg
|titre=Cet article doit être amélioré.
|texte=[[{{TALKPAGENAME}}|Discutez-en]] ou [{{fullurl:{{BASEPAGENAME}}|action=edit}} améliorez-le] !
}}