Modèle:BUtilisateur

De Les Archives de Vault-Tec
Documentation du modèle (pour le modèle ci-dessus, parfois caché ou invisible)


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

Constantes[modifier le wikicode]

  • largeur de la boîte : 238px
  • images et textes sont centrés dans leurs cellules
  • titre en gras

Modèles courants à recopier[modifier le wikicode]

Modèle de base
avec image, titre
et lien
Modèle simple
sans titre en haut
ni lien
Modèle avec double-image Modèle avec icône texte Modèle avec double-texte
{{BUtilisateur
 | couleur = 
 | img     = 
 | titre   = 
 | texte   = 
 | lien    = 
}}
{{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  = 
}}

Syntaxe[modifier le wikicode]

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

Notes :

  • le titre partage la même couleur que le texte.
  • le titre et le texte doivent être adaptés selon si il s'agit d'un utilisateur ou d'une utilisatrice en utilisant le modèle {{Genre utilisateur}}. Par exemple :
 {{genre utilisateur|masculin=utilisateur|féminin=utilisatrice|neutre=utilisateur(trice)}}

À l'exception des boîtes personnelles (situées dans l'espace de nom Utilisateur: ou Utilisatrice:), il faut ajouter :

{{BUtilisateur
 | ...
}}<noinclude>
{{Documentation boîte utilisateur}}
[[Catégorie:<--catégorie-->|<--nom boîte-->]]
</noinclude>

Exemple :

{{BUtilisateur
 | ...
}}<noinclude>
{{Documentation boîte utilisateur}}
[[Catégorie:Boîte utilisateur signe du zodiaque|Verseau]]
</noinclude>

Note : ne pas aller à la ligne entre le « }} » et le <noinclude> (conformément à Aide:Créer un modèle#Les balises d’inclusion sélective).

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 = 21x21px       <!-- facultatif mais conseillé - par défaut, 45x45px -->
 | 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 = 21x21px    <!-- facultatif mais conseillé - par défaut, 45x45px -->
 | 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 imgd2 en seconde ligne :

 | imgd2        = logo2.svg    <!-- facultatif - si absent, pas d'image -->
 | imgd2-taille = 21x21px      <!-- facultatif mais conseillé - par défaut, 45x45px -->
 | 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)

La plupart des boîtes doivent contenir un lien de type Pages liées. Pour afficher celui-ci (sous la forme d'un triangle vers une page spéciale listant toutes les pages liées au modèle), il faut renseigner un paramètre supplémentaire :

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

Cependant, s'il existe déjà 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 dans la catégorie liée.

Dans le cas où un paramètre catégorie est ajouté, il faut alors, pour des raisons techniques, ajouter le paramètre nocat, sous la forme suivante :

 | nocat = {{{nocat|}}}

La forme doit être exactement celle-ci, sans variation de la syntaxe. Ce paramètre permet à un utilisateur ne désirant pas apparaître dans la catégorie liée à la boîte d'éviter d'être listé dans celle-ci, simplement en affectant une valeur quelconque au paramètre nocat lors de l'appel de la boîte sur sa page utilisateur. Notez que les utilisateurs n'apparaissant pas dans la catégorie peuvent tout de même être retrouvés, car ils apparaissent dans la liste des pages liées. Ce paramètre est donc purement esthétique, évitant d'ajouter une catégorie sur sa page utilisateur.

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.

Si aucune catégorie correspondante n'existe, ne pas la créer. Il est préférable d'attendre que la catégorie a bien lieu d'exister, c'est à dire qu'un nombre suffisant d'utilisateur utilisent la boîte. Voir pour cela les recommandations sur le nombre de pages catégorisées.

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

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). Il est possible d'utiliser la même couleur que le reste de la boîte en spécifiant comme valeur de paramètre transparent. Cela permet par exemple d'obtenir un fond homogène dans le cas où l'image permet la transparence (images au format .png et .svg)
  • 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=45x45px) 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=45x45px)
    • 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=45x45px)
    • 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=45x45px)
    • 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=mc2"
    • 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:Utilisateur".
  • 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.

Table des couleurs[modifier le wikicode]

Modèle:Principales couleurs

Exemples[modifier le wikicode]

Code Résultat
{{BUtilisateur
 | img       = Wikipedia-logo-v2-fr.svg
 | 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
{{BUtilisateur
 | img       = 
 | 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
{{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        = Quatre images
 | texte        = On peut placer jusqu’à quatre images dans la partie gauche.
}}
Armoiries LanguedocBlason Suisse
Blason Nord-pas-de-calaisBlason Champagne Ardennes
Quatre images
{{BUtilisateur
 | texte = {{genre utilisateur|masculin=Cet utilisateur|féminin=Cette utilisatrice|neutre=Cet(te) utilisateur(trice)}} 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             = {{genre utilisateur|masculin=Cet utilisateur|féminin=Cette utilisatrice|neutre=Cet(te) utilisateur(trice)}} est
'''<big><big>génial{{Genre utilisateur|féminin=e|neutre=(e)}}</big></big>'''.
}}
e=
mc²
{{BUtilisateur
 | img-couleur      = #FFBBBB
 | img-texte-taille = 13px
 | img-texte        = '''en-0'''
 | couleur          = #FFEEEE
 | bordure          = #FFBBBB
 | texte            = {{genre utilisateur|masculin=Cet utilisateur|féminin=Cette utilisatrice|neutre=Cet(te) utilisateur(trice)}}
'''[[: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

Licence pour Wikipédia

Le contenu de cette page a été entièrement ou partiellement copié sur Wikipédia, l'encyclopédie libre, et est donc sous licence Creative Commons Paternité-Partage des Conditions Initiales à l'Identique 3.0 non transposé. La version originale, son historique et ses auteurs peuvent être trouvés sur la page Wikipédia "Modèle:BUtilisateur".

Documentation transclues de Modèle:BUtilisateur/doc.