Modèle:BUtilisateur/Documentation

Un article de Wikipédia, l'encyclopédie libre.

Modèle | Tutoriel | Projet Boîte Utilisateur

Ce Méta-modèle permet de générer facilement des boîtes utilisateur standardisées.

[modifier] Constantes

• largeur de la boîte : 238px
• largeur de l'emplacement de l'icone : 45px
• images et textes sont centrés dans leurs cellules

[modifier] Modèles courants à recopier

{{BUtilisateur
  |couleur=
  |img=
  |titre=
  |texte=
  |catégorie=Utilisateur xxx
}}

{{BUtilisateur
  |couleur=
  |img=
  |img-titre=
  |texte=
}}

{{BUtilisateur
  |couleur=
  |img-couleur=
  |img=
  |img-taille=
  |img-titre=
  |img2=
  |img2-taille=
  |img2-titre=
  |titre=
  |texte=
}}

{{BUtilisateur
  |couleur=
  |img-couleur=
  |img-texte=
  |img-texte-couleur=
  |img-texte-taille=
  |titre=
  |texte=
}}

{{BUtilisateur
  |couleur=
  |img=
  |titre=
  |texte=
  |texte2=
}}

[modifier] Syntaxe

{{BUtilisateur
  |bordure=#999999             <!-- facultatif - par défaut, #999999 (gris) -->
  |couleur=#EEEEEE             <!-- facultatif - par défaut, #EEEEEE (gris clair) -->
  |texte-couleur=#000000       <!-- facultatif - par défaut, #000000 (noir) -->
  |img-couleur=#FFFFFF         <!-- facultatif - par défaut, #FFFFFF (blanc) -->
  |img=icone.svg               <!-- facultatif mais fortement conseillé - si absent, pas d'image -->
  |img-taille=45px             <!-- facultatif - par défaut, 45px -->
  |img-titre=Titre Icône       <!-- facultatif mais conseillé - par défaut, {{{img}}} -->
  |titre-taille=11px            <!-- facultatif - par défaut, 11px -->
  |titre=Poker                 <!-- facultatif - la boîte peut ne pas comporter de titre en gras  -->
  |texte-taille=11px            <!-- facultatif - par défaut, 11px (augmenter pour arabe et chinois) -->
  |texte=Je joue au [[poker]]. <!-- facultatif mais fortement conseillé - si absent, pas de texte -->
}}

Note : le titre partage la même couleur que le texte.

Dans le cas d'une boîte utilisateur non-personnelle, il faut ajouter :

<noinclude>
[[Catégorie: <--catégorie--> | <--nom boîte-->]]
</noinclude>

Exemple:

<noinclude>
[[Catégorie:Boîte utilisateur signe du zodiaque|Verseau]]
</noinclude>

Deux images

Si la boîte doit contenir deux images, l'une à côté de l'autre, il faut renseigner trois autres paramètres pour l'image de droite :

  |imgd=icone2.svg           <!-- facultatif - si absent, pas d'image -->
  |imgd-taille=45px          <!-- facultatif - par défaut, 45px -->
  |imgd-titre=Titre Icône 2  <!-- facultatif mais conseillé - par défaut, {{{imgd}}} -->

Si la boîte doit contenir deux images, l'une au dessus de l'autre, il faut renseigner trois autres paramètres pour la seconde ligne :

  |img2=logo.svg            <!-- facultatif - si absent, pas d'image -->
  |img2-taille=45px          <!-- facultatif - par défaut, 45px -->
  |img2-titre=Titre Logo     <!-- facultatif mais conseillé - par défaut, {{{img2}}} -->

Quatre images

La boîte peut contenir jusqu'à quatre images, img et imgd en première ligne, img2 et impd2 en seconde ligne :

  |imgd2=logo2.svg           <!-- facultatif - si absent, pas d'image -->
  |imgd2-taille=45px         <!-- facultatif - par défaut, 45px -->
  |imgd2-titre=Titre Logo 2  <!-- facultatif mais conseillé - par défaut, {{{imgd2}}} -->

Sans image: 1 ou 2 textes

À la place des 1 à 4 images, on peut mettre un texte :

  |img-texte=Abbrev          <!-- facultatif - si absent, pas de texte dans la partie gauche -->
  |img-texte-couleur=#000000 <!-- facultatif - par défaut, #000000 (noir) -->
  |img-texte-taille=14px     <!-- facultatif - par défaut, 14px -->

Si on veut ajouter un second texte séparé par un filet horizontal (par exemple une traduction dans une autre langue), on peut renseigner (ce second texte utilise les mêmes couleurs que le premier texte et le titre mais peut avoir une taille différente) :

  |texte2=I play [[poker]].  <!-- facultatif - si absent, pas de second texte séparé par un filet -->
  |texte2-taille=11px         <!-- facultatif - par défaut, 11px (augmenter pour arabe ou chinois) -->

Pages liée et catégorie(s)

Si la boîte doit contenir un lien de type Pages liées, il faut renseigner un paramètre supplémentaire (cela affiche un triangle vers une page spéciale listant toutes les pages liées au modèle) :

  |lien=Poker <!-- Fin du nom de la boîte utilisateur (ici pour le Modèle:Utilisateur Poker) -->

Cependant, s'il existe une catégorie correspondante pour les pages d'utilisateurs, on utilisera plutôt :

  |catégorie=Utilisateur Poker <!-- facultatif - en principe le même nom que la boîte utilisateur (ici pour le Modèle:Utilisateur Poker) -->
  |catégorie2=Utilisateur Tarot <!-- facultatif - pour une seconde catégorie (ici pour le Modèle:Utilisateur Tarot) -->

Avec ce paramètre, les utilisateurs qui insèrent cette boîte dans leur page personnelle ont leur page personnelle automatiquement catégorisée.

Note : on doit indiquer le nom complet de la catégorie, car pour des raisons de compatibilité avec d'ancien noms de catégories, le préfixe "Catégorie:Utilisateur xxx" n'est pas toujours présent (on trouve aussi "Catégorie:User xxx").

Pour simplifier la classification, il est préférable de ne catégoriser que dans une catégorie.

[modifier] Valeurs détaillées des paramètres

La boîte globale positionnée dans la page :

• bordure : facultatif (défaut=#999999, gris foncé) la couleur de bordure de la boîte, exemple : "black" ou "#0000FF"
• arrondi : facultatif (défaut=0) Les angles peuvent apparaître arrondis si le navigateur le permet

1. Mozilla : visible
2. Internet explorer : non visible

Valeur conseillée : 0.6em. S'exprime en px ou em

• align : facultatif, (défaut=left) ; Alignement de flottaison de la boîte, uniquement dans le cas d'une utilisation directement dans une page personnelle, mais pas dans un modèle de boîte commune. Les valeurs possibles sont left, center, right, ou none (boîte non flottante).

Partie de gauche : généralement l'image :

• img-couleur : facultatif (défaut=#FFFFFF, blanc) la couleur de fond de l'image ou des images, exemple : "#906090" ou "#ccc"; pour les drapeaux à bandes blanches le long d'un bord, il est utile de spécifier la couleur en #EEEEEE qui permet de remarquer la bande blanche du drapeau et mesurer ses proportions (par exemple, avec le drapeau de Monaco ou de l'Algérie).
• première image (optionnelle) :
  • img : facultatif (défaut=pas d'image) le nom de l'image, par exemple "Flag of France.svg"
  • img-taille : facultatif (défaut=45px) la largeur de l'image exprimée en pixels, exemple : "30px"; pour les images en paysages (drapeaux, la plupart des photos), inutile de spécifier le paramètre qui sert surtout à réduire la largeur par défaut pour que la hauteur ne dépasse pas 45px (ce qui conserve la taille des boîtes et permet de les aligner)
  • img-titre : facultatif (défaut=valeur du paramètre titre si défini ci-dessous, sinon nom de l'image) exemple : "Drapeau de la France"
• seconde image, à droite de la première image (optionnelle) :
  • imgd : facultatif (défaut=pas d'image)
  • imgd-taille : facultatif (défaut=45px)
  • imgd-titre : facultatif (défaut=nom de l'image)
• première image, en deuxième ligne, donc sous la première image (optionnelle) :
  • img2 : facultatif (défaut=pas d'image)
  • img2-taille : facultatif (défaut=45px)
  • img2-titre : facultatif (défaut=nom de l'image)
• seconde image, en deuxième ligne, à droite de la première image en deuxième ligne (optionnelle) :
  • imgd2 : facultatif (défaut=pas d'image)
  • imgd2-taille : facultatif (défaut=45px)
  • imgd2-titre : facultatif (défaut=nom de l'image)
• ou alors un texte (optionnel) :
  • img-texte : facultatif (défaut=pas de texte) le texte remplaçant l'image, par exemple "E=mc²"
  • img-texte-couleur : facultatif (défaut=#000) la couleur du texte/image, par exemple "red"
  • img-texte-taille : facultatif (défaut=14px) la taille du texte/image, par exemple "10px"

Partie de droite, le texte affiché :

• couleur : facultatif (défaut=#DDDDDD, gris clair) la couleur de fond de la boîte, exemple : "#906090" ou "#ccc"
• texte-couleur : facultatif (défaut=#000000, noir) la couleur des textes et du titre dans la boîte, exemple : "yellow" ou "#0CCCC"

  Normalement la couleur de boîte est claire (pastel), et les textes restent dans la couleur par défaut en noir (inutile de préciser texte-couleur sauf si le paramètre couleur précise une teinte foncée). Voir la charte graphique des boîtes

• Le titre facultatif (automatiquement en gras et sur une ligne séparée en haut du texte)
  • titre : facultatif (défaut=pas de titre) le titre de la boîte ; sera affiché en gras suivi d'un saut de ligne; s'il est défini, il sert aussi de titre par défaut pour la première image (cas d'utilisation le plus courant)
  • titre-taille : facultatif (défaut=texte-taille si défini, sinon 11px; augmenter à 13px pour l'arabe ou le chinois)
• Le texte principal (affiché directement dans un paragraphe sous le titre)
  • texte : obligatoire, mais sa valeur peut être vide, le texte de la boîte, à la suite du titre
  • texte-taille : facultatif (défaut=11px, augmenter à 13px pour l'arabe ou le chinois)
• Un second texte optionnel (séparé du titre et du premier texte par un mince filet horizontal de la couleur de la bordure).
  • texte2 : facultatif (défaut=pas de texte) un second paragraphe, par exemple pour le texte dans une seconde langue.
  • texte2-taille : facultatif (défaut=texte-taille si défini, sinon 11px; augmenter à 13px pour l'arabe ou le chinois)

Partie optionnelle : un lien de navigation en bas à droite (un petit triangle pointé vers le bas). On peut afficher ce lien de deux façons exclusives l'une de l'autre :

• soit vers une page spéciale "Special:Whatlinkshere" :
  • lien : facultatif, le nom du modèle de boîte lui-même sans le préfixe "Modèle:".
• soit vers une catégorie d'utilisateurs de cette boîte qui y seront automatiquement catégorisés :
  • catégorie : facultatif, indique le nom de la catégorie des utilisateurs de cette boîte, sans le préfixe "Catégorie:". Noter que seules les pages de l'espace "Utilisateur:" y seront catégorisées. On peut utiliser la même boîte ailleurs dans des discussions ou dans "Wikipédia:" sans que ces discussions soient catégorisées parmi les utilisateurs de la boîte. Note: si on utilise ce paramètre, le paramètre "lien=Utilisateur ...|" mentionnant le nom du modèle est ignoré et c'est le lien vers la catégorie d'utilisateurs qui apparaîtra.
• Pour n'afficher aucun lien, il suffit de ne renseigner dans la boîte ni le paramètre lien, ni le paramètre catégorie.

[modifier] Table des couleurs

[modifier] Exemples

Code	Résultat
{{BUtilisateur |img=Wiki.png |img-titre=Wikipédia |couleur=#d0ffe0 |titre=[[Wikipédia]] |texte=Mon encyclopédie libre et gratuite est '''[[Wikipédia]]'''. |catégorie=Wikipédiens }}	∇ Wikipédia Mon encyclopédie libre et gratuite est Wikipédia.
{{BUtilisateur |img=SantaClaus.jpg |img-titre=Père Noël |couleur=#FF8080 |titre=Père Noël |texte=Je crois au '''[[Père Noël]]'''. |catégorie=Utilisateur Père Noël }}	∇ Père Noël Je crois au Père Noël.
{{BUtilisateur |img=Blason_Languedoc.svg |img-titre=Armoiries Languedoc |img-taille=21px |imgd=Swiss-coat of arms.svg |imgd-titre=Blason Suisse |imgd-taille=21px |img2=Blason_Nord-Pas-De-Calais.svg |img2-titre=Blason Nord-pas-de-calais |img2-taille=21px |imgd2=Blason région fr Champagne-Ardenne.svg |imgd2-titre=Blason Champagne Ardennes |imgd2-taille=21px |couleur=#FFF0F5 |titre=4 images |texte=On peut placer jusqu’à quatre images dans la partie gauche. }}	Quatre images On peut placer jusqu’à quatre images dans la partie gauche.
{{BUtilisateur |texte=Cet utilisateur ne s’intéresse à rien. }}	Cet utilisateur ne s’intéresse à rien.
{{BUtilisateur |img-couleur=red |img-texte-couleur=yellow |img-texte-taille=12px |img-texte='''e=<br />mc²''' |couleur=darkblue |texte-couleur=white |texte=Cet utilisateur est un '''<big><big>génie</big></big>'''. }}	e= mc² Cet utilisateur est un génie.
{{BUtilisateur |img-couleur=#FFBBBB |img-texte-taille=13px |img-texte='''en-0''' |couleur=#FFEEEE |bordure=#FFBBBB |texte=Cet utilisateur '''[[:Catégorie:Utilisateur en|ne comprend rien]]''' à l’'''[[:Catégorie:Utilisateur en|anglais]]''', ou ne veut pas parler cette langue. |texte2=This user '''[[:Catégorie:Utilisateur en|does not]]''' speak '''[[:Catégorie:Utilisateur en|English]]''', or does not want to speak English. |catégorie=Utilisateur en-0| }}	en-0 ∇ Cet utilisateur ne comprend rien à l’anglais, ou ne veut pas parler cette langue. This user does not speak English, or does not want to speak English.