Modèle:BUtilisateur/Documentation

Documentation du modèle

Ceci est la page de documentation de Modèle:BUtilisateur. · ·

Modèle | Tutoriel | Projet Boîte Utilisateur

Le méta-modèle {{BUtilisateur}} permet de générer facilement des boîtes utilisateurs normalisées.

• largeur de la boîte : 238px
• largeur de l’emplacement de l’icône : 45px
• images et textes sont centrés dans leurs cellules

{{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=
}}

{{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=8pt   <!-- facultatif - par défaut, 8pt -->
 |titre=Poker     <!-- facultatif - la boîte peut ne pas comporter de titre en gras -->
 |texte-taille=8pt   <!-- facultatif - par défaut, 8pt (augmenter pour arabe et chinois) -->
 |texte=Je joue au ]. <!-- 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>
]
</noinclude>

Exemple:

<noinclude>
]
</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=14pt  <!-- facultatif - par défaut, 14pt -->

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 ]. <!-- facultatif - si absent, pas de second texte séparé par un filet -->
 |texte2-taille=8pt   <!-- facultatif - par défaut, 8pt (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’anciens 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.

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 pt, 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 (1794–1815, 1830–1974, 2020–present).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=14pt) la taille du texte/image, par exemple "10pt"

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 8pt; augmenter à 13pt 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=8pt, augmenter à 13pt 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 8pt; augmenter à 13pt 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.

Code	Résultat
{{BUtilisateur |img=WiktionaryFr.svg |img-titre=Wikipédia |couleur=#d0ffe0 |titre=] |texte=Mon encyclopédie libre et gratuite est ''']'''. |catégorie=Wikipédiens }}	∇ Wikipédia Mon encyclopédie libre et gratuite est Wikipédia.
{{BUtilisateur |img= |img-titre=Père Noël |couleur=#FF8080 |titre=Père Noël |texte=Je crois au ''']'''. |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=Coat of Arms of Switzerland.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=12pt |img-texte='''E=<br />mc²''' |couleur=darkblue |texte-couleur=white |texte=Cet utilisateur est un '''<span style="font-size:20px;">génie</span>'''. }}	E= mc² Cet utilisateur est un génie.
{{BUtilisateur |img-couleur=#FFBBBB |img-texte-taille=13pt |img-texte='''en-0''' |couleur=#FFEEEE |bordure=#FFBBBB |texte=Cet utilisateur ''']''' à l’''']''', ou ne veut pas parler cette langue. |texte2=This user ''']''' speak ''']''', 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.
{{BUtilisateur |couleur=#97DFC6 |img=Noto Emoji v2.034 1f4c8.svg |img-taille=35px |img-titre=Nouveau |titre=Mes stastistiques |texte= }}	Mes stastistiques Compteur d’édition