Aide:Créer une infobox
Une infobox doit rester synthétique, elle ne doit pas remplacer l'article mais le compléter, fournir une vue globale, par l'apport d'informations générales. Les informations contenues dans les infobox doivent en principe figurer dans le corps de l'article. Peuvent faire exceptions les données normatives (code postal, domaine internet etc.) ou encore certains chiffres clés (ex : PIB pour un article dédié à un pays). Une autre fonction des infobox est de faciliter la navigation entre articles qui sont par nature intimement liés.
Conventions de titre
modifierLes titres des infobox doivent respecter la convention : « Modèle:Infobox Nom » (convention établie par un sondage) et sont appelés dans les articles par la syntaxe {{Infobox Nom}}
- On écrit la première lettre de Nom avec une majuscule.
- On peut utiliser plusieurs mots pour définir l’infobox ; dans ce cas, on ajoute des espaces :
{{Infobox Cours d'eau}}
- On n’utilise PAS d’abréviation dans les noms des infobox (sauf pour USA et URSS) :
{{Infobox Prov. Mar.}}
- On peut utiliser des acronymes (comme pour USA et URSS)
- On écrit le nom en français.
- On ne supprime pas les mots de liaison :
{{Infobox Province du Maroc}}
et non{{Infobox Province Maroc}}
- Les règles de typographie françaises doivent être impérativement respectées.
- Pour des raisons d’homonymie, on préférera les noms aux adjectifs :
{{Infobox Province du Maroc}}
et non{{Infobox Province marocaine}}
- Dans le cas où un même modèle doit être décliné en plusieurs versions :
- on tentera de limiter le nombre de versions en utilisant les fonctions du parseur pour des infobox génériques ;
- sinon, on nommera les différentes versions
{{Infobox Commune de Suisse/neutre}}
,{{Infobox Commune de Suisse/sans district}}
. On ne mettra pas de majuscule après le /. - Mauvais :
,{{Infobox Commune de Suisse (neutre)}}
{{Infobox Commune de Suisse sans district}}
Paramètres
modifierLes champs/paramètres des infobox doivent respecter les conventions de nommage et de présentation suivantes :
- Ils commencent tous par une minuscule, sauf s’il s’agit d’un nom propre.
- Lorsque le nom d’un champ nécessite plusieurs mots, on les séparera par des espaces.
- Dans la mesure du raisonnable, on n’utilisera pas d’abréviations.
- Dans la mesure du possible, on essaiera de reprendre les mêmes noms que les champs d’infobox similaires.
- Dans les articles, pour des questions de lisibilité, on présentera les champs des infobox ainsi :
{{Infobox Province du Maroc | province = nom de la province | région = nom de la région ... }}
- De préférence, on mettra en début de ligne une espace, le caractère | (obtenu avec la combinaison Alt + Maj + L sous Mac OS, avec la combinaison Alt Gr + 6 sous Linux et Windows, ou encore Ctrl + Alt + 6 sous Windows) puis une autre espace, puis le nom du champ ; on mettra le = entre deux espaces.
- On terminera par une ligne ne contenant que }}
Importation depuis un Wikipédia dans une autre langue
modifierPlutôt que de construire une infobox à partir de zéro, il peut être plus facile et plus rapide de s’appuyer sur une infobox de Wikipédia déjà présente dans une autre langue (la version en anglais en possède un nombre important et dans un état bien avancé). Pour s’éviter un travail de syntaxe fastidieux, on peut ainsi se contenter de traduire certaines de ces infobox.
- Lorsque l’on est dans le cas où le modèle n’a pas d’équivalent en français, on commence d’abord par créer un nouveau modèle de la forme Modèle:Infobox XXX, avec XXX le nom en français (dans notre exemple cela donne Modèle:Infobox Format de données). Ce modèle sera celui qui sera utilisé directement par les articles et donc visible par les lecteurs, il faut donc bien prendre soin de le traduire (ne pas oublier le nom des variables).
- Puis on crée un deuxième modèle, nommé Modèle:Infobox file format, qui servira par la suite de « modèle de transition ». Dans ce modèle doit être placé un simple appel au modèle en français ({{Infobox Format de données}}) et dont les paramètres prennent pour valeur ceux de l’équivalent en anglais (ex : {{{nom}}}={{{name|}}}). Pour tout paramètre, il est possible de préciser une valeur par défaut qu’il prendra automatiquement si aucune valeur ne lui a été donnée lors de l’appel. Dans notre cas, on décide donc une valeur vide, ce qui permettra de laisser un paramètre vide s’il n'a pas été précisé en anglais. Par exemple, pour la valeur du paramètre
mime
, si dans l’article en anglaismime
rien n’a été précisé, il en sera de même en français. - Une fois les deux modèles mis en place, il est possible d’obtenir dans l’article en français la même infobox qu’en anglais en faisant un simple copier-coller. Le travail restant se résume à la traduction des valeurs des paramètres, toute la syntaxe sera quant à elle être traduite automatiquement au moment de publier les modifications. Pour cela il faut demander explicitement la substitution du modèle. Dans notre exemple cela donne :
{{subst:Infobox file format| name = ...
.
Créer une infobox en Lua
modifierDocumenter l'infobox
modifierStructure
modifierLa structure de base est celle-ci :
== Syntaxe ==
: Code vierge à copier dans les articles, en tout cas la version de base.== Paramètres ==
: Détails des paramètres, généralement rédigé en wikicode, peut aussi être remplacé par le bloc TemplateData pour les modèles assez simples.== Exemple ==
: Un ou plusieurs exemples de rendu.== TemplateData ==
: Le bloc de données TemplateData, à moins qu'il ait été placé dans la section « Paramètres ».== Voir aussi ==
ou similaire : Si modèles connexes.
TemplateData
modifierIl est indispensable d'insérer des données TemplateData dans la documentation pour que le modèle puisse être correctement utilisé avec l'éditeur visuel. Il faut tout d'abord insérer une description indiquant dans quel cas l'utiliser.
Ensuite, il faut définir un format personnalisé pour permettre la mise en forme correcte du wikicode généré par l'éditeur visuel. Exemple :
{{_\n | _______________ = _\n}}\n
Pour cela, il faut compter le nombre de caractères (espaces compris) du plus long paramètre couramment utilisé[1] dans les articles (même s'il reste vide). Ensuite, écrire autant de tirets bas qu'il y a de caractères. Il ne faut en revanche pas compter les espaces avant le début et la fin du paramètre.
Sans ce format correctement défini, ou si le format « Multiligne » (block
) est utilisé, tout contributeur ajoutant ou modifiant cette infobox avec l'éditeur visuel détruira l'alignement vertical des paramètres dans le wikicode. Un format correctement défini permet de conserver ou rétablir cette mise en forme, y compris en cas d'ajouts ou suppressions de paramètres.
Notes
modifier- Les paramètres d'usage très rare, présents dans moins de 5 % des articles, ne devraient généralement pas être pris en compte.