Modèle:Documentation boîte utilisateur/Documentation
Utilisation et paramètres
modifierCe modèle est destiné à être apposé sur les modèles de boîtes utilisateur afin de guider les contributeurs désireux d'en utiliser dans la manière de les apposer sur leur page utilisateur. Il affiche automatiquement le contenu de la sous-page /Documentation
si elle existe, ou bien un contenu spécifique passé par le paramètre contenu
. Il est possible de cibler une page de documentation autre que la sous-page /Documentation
en utilisant le paramètre page doc
.
Les autres paramètres sont les suivants :
Pour la plupart des boîtes utilisateur, il suffit d'ajouter : {{Documentation boîte utilisateur}} au modèle, entre les balises noinclude. Si la boîte contient une sous-page de documentation, celle-ci est automatiquement affichée en tant que contenu de ce modèle.
Boîte avec accord de genre
modifierSi la boîte s'accorde en genre automatiquement, il faut ajouter le paramètre accord
pour le signifier. La syntaxe est alors : {{Documentation boîte utilisateur|accord=oui}}
Boîte ajustable
modifierPour les boîtes ajustables, c'est-à-dire les boîtes hautes possédant un paramètre permettant de réduire le contenu et leur donner une taille standard, le paramètre ajustable
doît être ajouté à cette documentation : {{Documentation boîte utilisateur|ajustable=oui}}
Langues
modifierPour les boîtes utilisateur linguistiques, ajouter les deux paramètres obligatoires suivants :
langue
: texte à afficher (par exemple,le [[français]]
)initiales
: initiales de la langue (par exemple,fr
)
Alphabets
modifierPour les boîtes utilisateur d'alphabets comportant plusieurs boîtes de niveau, ajouter les deux paramètres obligatoires suivants :
alphabet
: texte à afficher (par exemple,l'[[Alphabet phonétique international]]
)initiales
: initiales utilisées pour nommer les boîtes (par exemple,API
)
Boîtes destinées aux catégories
modifierNormalement, les boîtes utilisateurs sont destinées aux pages utilisateur. Dans le cas particulier des boîtes de langue et d'alphabet dont le nom finit par "-*", celles-ci sont destinées à un affichage sur les catégories. Dans ce cas, il faut ajouter le paramètre pour catégorie=oui
.
Template data
modifierCe modèle est destiné à être apposé sur les modèles de boîtes utilisateur afin de guider les contributeurs désireux d'en utiliser dans la manière de les apposer sur leur page utilisateur.
Paramètre | Description | Type | État | |
---|---|---|---|---|
accord | accord | Permet d'indiquer que la boîte s'accorde automatiquement en genre. Ajouter le paramètre avec n'importe quelle valeur pour activer. | Chaîne | facultatif |
ajustable | ajustable | À ajouter sur une boîte haute qui prend en charge l'ajustement en hauteur à l'aide du paramètre 'alt'. Ajouter le paramètre avec n'importe quelle valeur pour activer. | Chaîne | facultatif |
langue | langue | Pour les boîtes de langue, indique le texte à afficher pour décrire la langue. Si ce paramètre est renseigné, il faut également indiquer le paramètre 'initiales'.
| Chaîne | facultatif |
alphabet | alphabet | Pour les boîtes d'alphabet, indique le texte à afficher pour décrire l'alphabet. Si ce paramètre est renseigné, il faut également indiquer le paramètre 'initiales'.
| Chaîne | facultatif |
initiales | initiales | Pour les boîtes de langue et d'alphabet, indique le code utilisé par les boîtes.
| Chaîne | facultatif |
pour catégorie | pour catégorie | Pour les boîtes de langue et d'alphabet, indique que la boîte est destiné aux catégories et non aux pages utilisateur (boîtes dont le nom finit par '-*'). Ajouter le paramètre avec n'importe quelle valeur pour activer. | Chaîne | facultatif |
contenu | contenu | Permet d'ajouter un contenu supplémentaire décrivant l'utilisation de la boîte. | Chaîne | facultatif |