Modèle:Documentation boîte utilisateur
Utilisation et paramètres
Ce 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
Si 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
Pour 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}}
Babel et alphabets
Langues
Pour 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
Pour 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
Normalement, 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
Ce 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 |
La documentation de ce modèle est générée par le modèle {{Documentation}}.
Elle est incluse depuis sa sous-page de documentation. Veuillez placer les catégories sur cette page-là.
Les éditeurs peuvent travailler dans le bac à sable (créer) et la page de test (créer).
Voir les statistiques d'utilisation du modèle sur l'outil wstat.