Modèle:Méta bandeau d'avertissement/Documentation : Différence entre versions

De Les Mots de l'agronomie
imported>Jacques Ducloy
m (1 version)
imported>Jacques Ducloy
m (1 révision importée)
 
Ligne 1 : Ligne 1 :
{{Documentation modèle en sous-page}}
+
{{Sous-page de documentation}}<includeonly>
{{Modèle importé de Wikipédia}}
+
{{Protection}}
<includeonly>{{Job queue}}</includeonly>
+
{{Avertissement méta-modèle}}
Ce modèle est utilisé dans d'autres modèles pour construire des bandeaux d'avertissements conformes à la charte graphique. Il n'est pas destiné à être utilisé directement dans les articles.
+
</includeonly>
 +
 
 +
== Utilisation ==
 +
Ce modèle est utilisé dans d'autres modèles pour construire des bandeaux d'avertissements conformes à la charte graphique.
 +
 
 
== Syntaxe ==
 
== Syntaxe ==
 
  <nowiki>{{</nowiki>Méta bandeau d'avertissement
 
  <nowiki>{{</nowiki>Méta bandeau d'avertissement
 
  | niveau = ''grave'', ''modéré'', ''ébauche'', ou ''information'' (obligatoire)
 
  | niveau = ''grave'', ''modéré'', ''ébauche'', ou ''information'' (obligatoire)
 
  | icône = ''nom de l'image'' (facultatif)
 
  | icône = ''nom de l'image'' (facultatif)
 +
| alt = alternative textuelle de l'icône (obligatoire si icône est le nom d'une image)
 
  | titre = ''titre de l'avertissement'' (obligatoire)
 
  | titre = ''titre de l'avertissement'' (obligatoire)
 
  | texte = ''texte de l'avertissement'' (facultatif)
 
  | texte = ''texte de l'avertissement'' (facultatif)
 
  <nowiki>}}</nowiki>
 
  <nowiki>}}</nowiki>
  
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é.
+
D'autre part, le paramètre <code>icône</code> peut être remplacé par un paramètre <code>icône-complexe</code>, et des paramètres <code>id</code> et <code>supplément</code> peuvent être ajoutés.
  
== Explication des paramètres ==
+
== Paramètres ==
=== Paramètre « niveau » ===
+
=== <code>niveau</code> ===
Type de bandeau. Voici quelques indications pour choisir le '''niveau''' :
+
Type de bandeau. Voici quelques indications pour choisir le niveau :
 +
* '''Niveau « grave »''' : Nécessité de modification urgente, violation manifeste d'un [[:Catégorie:Principe fondateur de Wikipédia|principe fondateur]] (non neutralité de point de vue, etc.), ou d'une [[:Catégorie:Règle de Wikipédia|règle]] (travail inédit, etc.), disparition prochaine possible de contenu (violation de copyright, proposition de suppression, etc.)
 +
* '''Niveau « modéré »''' : Besoin de modification sur 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 {{m|ébauche}}. Par défaut, le style est le même que pour les bandeaux de niveau « information ».
 +
* '''Niveau « information »''' : Avertissements permanents, y compris les avertissement d'évènement récents ou futurs. (Les bandeaux de maintenance, les annonces de travaux, etc. sont exclus.)
  
;niveau « grave »
+
=== <code>icône</code> ===
Nécessité de modification urgente, violation manifeste d'un [[:Catégorie:Principe fondateur de Wikipédia|principe fondateur]] (non neutralité de point de vue, etc.), ou d'une [[:Catégorie:Règle officielle de Wikipédia|règle officielle]] (travail inédit, etc.), disparition prochaine possible de contenu (violation de copyright, proposition de suppression, etc.)
+
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 permet d'insérer l'image dans un rectangle de {{Dunité|45|45|pixels}}. 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.
  
;niveau « modéré »
+
Par exemple, les icônes des collections [[:commons:Nuvola/all|Nuvola]] et [[:commons:Crystal Clear|Crystal Clear]] conviennent particulièrement bien du point de vue graphique.
Besoin de modification sur l'article (à internationaliser, etc.), annonce de travail en cours (traduction, etc.), à l'exception des bandeaux d'ébauche.
 
(Les avertissements permanents sont exclus.)
 
  
;niveau « ébauche »
+
Pour l'accessibilité du bandeau, si un nom d'icône est précisé, il faut renseigner le paramètre <var>alt</var>, alternative textuelle de l'image.
Bandeaux d'ébauche. Un tel paramètre devrait être utilisé uniquement par le modèle {{m|ébauche}}. Par défaut, le style est le même que pour les bandeaux de niveau « modéré ».
 
  
;niveau « information »
+
=== <code>titre</code> et <code>texte</code> ===
Avertissements permanents, y compris les avertissement d'évènement 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 apparaitre à 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 permet 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 [[:commons:Nuvola/all|Nuvola]] et [[:commons:Crystal Clear|Crystal Clear]] 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.
 
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 » ===
+
=== <code>date</code> ===
;icône-complexe
+
Affiché à droite du titre, sur la même ligne mais sans formatage.
: À utiliser à la place du paramètre ''icône'', pour remplacer l'image par du contenu quelconque. Par exemple, le modèle {{m|Ébauche}} utilise 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 {{m|Titre incorrect}} utilise « id = RealTitleBanner » (voir la documentation de ce modèle pour en comprendre l'utilité).
 
  
;supplément
+
=== Paramètres supplémentaires ===
:Contenu supplémentaire à afficher en dessous du contenu du bandeau proprement dit. Par exemple, le bandeau {{m|À fusionner}} utilise 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 ».
+
* <code>icône-complexe</code> : À utiliser à la place du paramètre ''icône'', pour remplacer l'image par du contenu quelconque. Par exemple, le modèle {{m|Ébauche}} utilise un tel paramètre pour afficher plusieurs icônes lorsque plusieurs thèmes lui sont fournis. À utiliser avec parcimonie.
 +
* <code>id</code> : Affecte un identificateur au bandeau (correspond à l'attribut « id » en [[HTML]]).  Par exemple, le bandeau {{m|Titre incorrect}} utilise « id = RealTitleBanner » (voir la documentation de ce modèle pour en comprendre l'utilité).
 +
* <code>supplément</code> : Contenu supplémentaire à afficher en dessous du contenu du bandeau proprement dit. Par exemple, le bandeau {{m|À fusionner}} utilise 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 ==
+
== Exemples ==
 
+
=== Avec le paramètre <code>icône</code> ===
=== Avec le paramètre « icône » ===
+
{| class="wikitable" style="width:100%;"
{|width="100%" border="1" cellspacing="0" cellpadding="2" style="border:1px solid #aaa;border-collapse:separate"
+
! width="50%"| Code
 +
! width="50%"| Rendu
 
|-
 
|-
!width="50%"|Code
+
| width="50%"|
!width="50%"|Rendu
+
<pre>{{Méta bandeau d'avertissement
|-
+
| niveau = modéré
|width="50%"|
+
| icône = Nuvola apps locale.png
<poem><nowiki>{{Méta bandeau d'avertissement
+
| alt    = drapeaux
|niveau=</nowiki>'''modéré'''<nowiki>
+
| titre = Cet article doit être [[wikipédia:Guide d'internationalisation|internationalisé]].
|icône=Nuvola apps locale.png
+
| texte = Cet article adopte un point de vue régional ou culturel particulier et doit être internationalisé. [[{{TALKPAGENAME}}|Discutez-en]] ou [{{fullurl:{{BASEPAGENAME}}|action=edit}} améliorez-le] !
|titre=Cet article doit être [[wikipédia:Guide d'internationalisation|internationalisé]].
+
}}</pre>
|texte=Cet article adopte un point de vue régional ou culturel particulier et doit être internationalisé. [[{{TALKPAGENAME}}|Discutez-en]] ou [{{fullurl:{{BASEPAGENAME}}|action=edit}} améliorez-le] !
+
| width="50%"|
}}</nowiki></poem>
 
|width="50%"|
 
 
{{Méta bandeau d'avertissement
 
{{Méta bandeau d'avertissement
|niveau=modéré
+
| niveau = modéré
|icône=Nuvola apps locale.png
+
| icône = Nuvola apps locale.png
|titre=Cet article doit être [[wikipédia:Guide d'internationalisation|internationalisé]].
+
| alt    = drapeaux
|texte=Cet article adopte un point de vue régional ou culturel particulier et doit être internationalisé. [[{{TALKPAGENAME}}|Discutez-en]] ou [{{fullurl:{{BASEPAGENAME}}|action=edit}} améliorez-le] !
+
| titre = Cet article doit être [[wikipédia:Guide d'internationalisation|internationalisé]].
 +
| texte = Cet article adopte un point de vue régional ou culturel particulier et doit être internationalisé. [[{{TALKPAGENAME}}|Discutez-en]] ou [{{fullurl:{{BASEPAGENAME}}|action=edit}} améliorez-le] !
 
}}
 
}}
 
|}
 
|}
  
=== Sans paramètre « icône » ===
+
=== Sans paramètre <code>icône</code> ===
Une icône générique est fournie
+
Une icône générique est fournie.
{|width="100%" border="1" cellspacing="0" cellpadding="2" style="border:1px solid #aaa;border-collapse:separate"
+
{| class="wikitable" style="width:100%;"
|-
+
! width="50%"| Code
!width="50%"|Code
+
! width="50%"| Rendu
!width="50%"|Rendu
 
 
|-
 
|-
|width="50%"|
+
| width="50%"|
<nowiki>{{Méta bandeau d'avertissement</nowiki>
+
<pre>{{Méta bandeau d'avertissement
<br/><nowiki>|niveau=</nowiki>'''grave'''
+
| niveau = grave
<br/><nowiki>|</nowiki>titre=Bandeau de niveau grave.
+
| titre = Bandeau de niveau grave.
<br/><nowiki>|</nowiki>texte=Alerte avec icône générique.
+
| texte = Alerte avec icône générique.
<br/><nowiki>}}</nowiki>
+
}}</pre>
|width="50%" style="border-left:1px solid #aaa;border-top:1px solid #aaa"|
+
| width="50%"|
 
{{Méta bandeau d'avertissement
 
{{Méta bandeau d'avertissement
|niveau=grave
+
| niveau = grave
|titre=Bandeau de niveau grave.
+
| titre = Bandeau de niveau grave.
|texte=Alerte avec icône générique.
+
| texte = Alerte avec icône générique.
 
}}
 
}}
 
|-
 
|-
|width="50%"|
+
| width="50%"|
<poem><nowiki>{{Méta bandeau d'avertissement
+
<pre>{{Méta bandeau d'avertissement
|niveau=</nowiki>'''modéré'''<nowiki>
+
| niveau = modéré
|titre=Bandeau de niveau modéré.
+
| titre = Bandeau de niveau modéré.
|texte=Avertissement avec icône générique.
+
| texte = Avertissement avec icône générique.
}}</nowiki></poem>
+
}}</pre>
|width="50%"|
+
| width="50%"|
 
{{Méta bandeau d'avertissement
 
{{Méta bandeau d'avertissement
|niveau=modéré
+
| niveau = modéré
|titre=Bandeau de niveau modéré.
+
| titre = Bandeau de niveau modéré.
|texte=Avertissement avec icône générique.
+
| texte = Avertissement avec icône générique.
 
}}
 
}}
 
|-
 
|-
|width="50%"|
+
| width="50%"|
<poem><nowiki>{{Méta bandeau d'avertissement
+
<pre>{{Méta bandeau d'avertissement
|niveau=</nowiki>'''ébauche'''<nowiki>
+
| niveau = ébauche
|titre=Bandeau de niveau ébauche.
+
| titre = Bandeau de niveau ébauche.
|texte=Ébauche avec icône générique.
+
| texte = Ébauche avec icône générique.
}}</nowiki></poem>
+
}}</pre>
|width="50%"|
+
| width="50%"|
 
{{Méta bandeau d'avertissement
 
{{Méta bandeau d'avertissement
|niveau=ébauche
+
| niveau = ébauche
|titre=Bandeau de niveau ébauche.
+
| titre = Bandeau de niveau ébauche.
|texte=Ébauche avec icône générique.
+
| texte = Ébauche avec icône générique.
 
}}
 
}}
 
|-
 
|-
|width="50%"|
+
| width="50%"|
<poem><nowiki>{{Méta bandeau d'avertissement
+
<pre>{{Méta bandeau d'avertissement
|niveau=</nowiki>'''information'''<nowiki>
+
| niveau = information
|titre=Bandeau de niveau information.
+
| titre = Bandeau de niveau information.
|texte=Information avec icône générique.
+
| texte = Information avec icône générique.
}}</nowiki></poem>
+
}}</pre>
|width="50%"|
+
| width="50%"|
 
{{Méta bandeau d'avertissement
 
{{Méta bandeau d'avertissement
|niveau=information
+
| niveau = information
|titre=Bandeau de niveau information.
+
| titre = Bandeau de niveau information.
|texte=Information avec icône générique.
+
| texte = Information avec icône générique.
 
}}
 
}}
 
|}
 
|}
<includeonly>
 
  
[[Catégorie:Modèle de bandeau|*]]
+
=== Avec le paramètre <code>date</code> ===
 +
{| class="wikitable" style="width:100%;"
 +
! width="50%"| Code
 +
! width="50%"| Rendu
 +
|-
 +
| width="50%"|
 +
<pre>{{Méta bandeau d'avertissement
 +
| niveau = modéré
 +
| titre  = Bandeau de niveau modéré.
 +
| date  = &amp;nbsp;<small>(octobre 2012)</small>
 +
| texte  = Avertissement avec icône générique.
 +
}}</pre>
 +
| width="50%"|
 +
{{Méta bandeau d'avertissement
 +
| niveau = modéré
 +
| titre  = Bandeau de niveau modéré.
 +
| date  = &nbsp;<small>(octobre 2012)</small>
 +
| texte  = Avertissement avec icône générique.
 +
}}
 +
|}<includeonly>
 +
[[Catégorie:Exclure lors de l'impression]]
 +
[[Catégorie:Modèle de bandeau| ]]
 
[[Catégorie:Méta-modèle|Bandeau d'avertissement]]
 
[[Catégorie:Méta-modèle|Bandeau d'avertissement]]
 
<!-- ADD INTERWIKIS BELOW THIS LINE -->
 
 
[[en:Template:Ambox]]
 
 
 
</includeonly>
 
</includeonly>

Version actuelle datée du 7 décembre 2020 à 16:43

Illustration de documentation
Ceci est la page de documentation de Modèle:Méta bandeau d'avertissement [modifier] [purger].
Cette sous-page contient les instructions, les catégories de son modèle d'origine et elle n'est pas destinée à être visualisée directement.

Utilisation

Ce modèle est utilisé dans d'autres modèles pour construire des bandeaux d'avertissements conformes à la charte graphique.

Syntaxe

{{Méta bandeau d'avertissement
| niveau = grave, modéré, ébauche, ou information (obligatoire)
| icône = nom de l'image (facultatif)
| alt = alternative textuelle de l'icône (obligatoire si icône est le nom d'une image)
| 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.

Paramètres

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 règle (travail inédit, etc.), disparition prochaine possible de contenu (violation de copyright, proposition de suppression, etc.)
  • Niveau « modéré » : Besoin de modification sur 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 avertissement d'évènement récents ou futurs. (Les bandeaux de maintenance, les annonces de travaux, etc. sont exclus.)

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 permet d'insérer l'image dans un rectangle de Modèle:Dunité. 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 Nuvola et Crystal Clear conviennent particulièrement bien du point de vue graphique.

Pour l'accessibilité du bandeau, si un nom d'icône est précisé, il faut renseigner le paramètre alt, alternative textuelle de l'image.

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.

date

Affiché à droite du titre, sur la même ligne mais sans formatage.

Paramètres supplémentaires

  • 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}} utilise 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}} utilise « 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}} utilise 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

Avec le paramètre icône

Code Rendu
{{Méta bandeau d'avertissement
| niveau = modéré
| icône  = Nuvola apps locale.png
| alt    = drapeaux
| titre  = Cet article doit être [[wikipédia:Guide d'internationalisation|internationalisé]].
| texte  = Cet article adopte un point de vue régional ou culturel particulier et doit être internationalisé. [[{{TALKPAGENAME}}|Discutez-en]] ou [{{fullurl:{{BASEPAGENAME}}|action=edit}} améliorez-le] !
}}
drapeaux
Cet article doit être internationalisé.

Cet article adopte un point de vue régional ou culturel particulier et doit être internationalisé. Discutez-en ou améliorez-le !

Sans paramètre icône

Une icône générique est fournie.

Code Rendu
{{Méta bandeau d'avertissement
| niveau = grave
| titre  = Bandeau de niveau grave.
| texte  = Alerte avec icône générique.
}}
Bandeau de niveau grave.

Alerte avec icône générique.

{{Méta bandeau d'avertissement
| niveau = modéré
| titre  = Bandeau de niveau modéré.
| texte  = Avertissement avec icône générique.
}}
Bandeau de niveau modéré.

Avertissement avec icône générique.

{{Méta bandeau d'avertissement
| niveau = ébauche
| titre  = Bandeau de niveau ébauche.
| texte  = Ébauche avec icône générique.
}}
Bandeau de niveau ébauche.

Ébauche avec icône générique.

{{Méta bandeau d'avertissement
| niveau = information
| titre  = Bandeau de niveau information.
| texte  = Information avec icône générique.
}}
Bandeau de niveau information.

Information avec icône générique.

Avec le paramètre date

Code Rendu
{{Méta bandeau d'avertissement
| niveau = modéré
| titre  = Bandeau de niveau modéré.
| date   = &nbsp;<small>(octobre 2012)</small>
| texte  = Avertissement avec icône générique.
}}
Bandeau de niveau modéré. (octobre 2012)

Avertissement avec icône générique.