Projet:Infobox/Tutoriel infobox avec des briques
Didacticiel pour les modélistes désirant mettre en place une infobox standard à l'aide de briques.
Présentation
modifierPour les modèles d'infobox ne demandant pas de fonctions complexes particulières, il est vivement recommandé d'utiliser des briques pour la programmation d'une nouvelle infobox ou pour la mise à jour d'une ancienne infobox. Les briques sont un ensemble de modèles permettant, par leur association au moyen de différentes combinaisons, la mise en place de modèles d'infobox. L'enjeu ici est de simplifier la programmation des modèles d'infobox, mais également d'améliorer l'accessibilité ainsi que l'harmonisation des infobox.
Conventions d'harmonisation
modifierAfin d'obtenir une certaine uniformité d'un modèle à l'autre, veuillez programmer les infobox V2 avec une attention particulière en utilisant les exemples ci-après.
Nommage et renommage
modifierDans le cadre du Projet:Modèle/Harmonisation, il est fortement recommandé de nommer (ou renommer) votre infobox en respectant la nomenclature établie. Ceci relève des conventions sur les titres, aussi valables pour les noms de modèles. Voici quelques exemples de ce qu'il faut faire ou non :
Titre | Commentaire |
---|---|
Modèle:Infobox Nom de l'infobox | Avec « Infobox » au début, et une majuscule au Nom de l'infobox. Ne pas tronquer de mots. |
Toujours commencer avec le mot « Infobox ». | |
Toujours débuter le nom de l'infobox avec une capitale. | |
Ne pas mettre d'autres capitales dans le nom du modèle, sauf pour les noms propres. | |
Ne pas tronquer des mots, faire une phrase. Mieux vaut un nom de modèle clair qu'un nom trop court. | |
Éviter des mots anglophones. Ex : Comicbook, podcast, TV, etc. | |
Toujours utiliser les accents pour un titre. |
Paramétrage
modifierIl est important de bien nommer vos paramètres. En bref, pas de majuscules, pas d'acronymes, pas de diminutifs, pas de pluriel. Il est fortement conseillé aussi d'uniformiser l'emplacement des tubes « | » et des signes égal « = ».
Programmation des modèles
modifierVeuillez penser à créer des infoboxes génériques, qui incluent plusieurs autres infoboxes du même thème ayant les mêmes paramètres joints sous une charte graphique. Il existe plusieurs façons de programmer une infobox, mais nous vous conseillons tout de même quelques règles :
- pour éviter la prolifération d'infoboxes aux paramètres similaires, il est suggéré de créer des infoboxes génériques en utilisant la fonction {{#switch}} du parseur. Puis fusionnez les mêmes paramètres qui seront inclus d'une infobox à l'autre (voir {{Infobox Commune de France}} pour un exemple de sous-page d'infobox générique) ;
- évitez de faire apparaître les paramètres non renseignés. Il est possible de dissimuler les champs qui sont vides en utilisant les fonctions du parseur, qui valent mieux que les classes « hiddenstructure » ou autres techniques de dissimulation.
Liste des briques
modifierStructure | Lignes de tableau | Divers | ||
---|---|---|---|---|
Ouvertures et fermetures
Titres et sous-titres
Séparateurs
|
Ligne mixte
Ligne donnée
Ligne autre
|
Cartes
Images
Navigation
|
Programmation sans ajout de paramètres
modifierUsage des briques sans paramètres
modifierLes briques peuvent être utilisées directement sur une page sans avoir besoin d'y ajouter des paramètres du genre {{{paramètre1}}}... Cependant cet usage direct est déconseillé dans l'espace encyclopédique.
Exemple de briques sans paramètres
modifier
Titre | ||
Sous-titre 1 | ||
---|---|---|
Nom du champ | Sa valeur | |
Nom du champ | Sa valeur | |
Nom du champ | Sa valeur | |
Sa valeur | Sa valeur | |
Sa valeur | Sa valeur | |
Sous-titre 2 | ||
Géolocalisation sur la carte : France
| ||
modifier |
{{Infobox/Début}} {{Infobox/Titre|Titre|E1E1E1|map}} {{Infobox/Image|defaut.svg}} {{Infobox/Sous-titre|Sous-titre 1}} {{Infobox/Ligne mixte|Nom du champ|Sa valeur}} {{Infobox/Ligne mixte|Nom du champ|Sa valeur}} {{Infobox/Ligne mixte|Nom du champ|Sa valeur}} {{Infobox/Ligne donnée|Sa valeur|Sa valeur}} {{Infobox/Ligne donnée|Sa valeur|Sa valeur}} {{Infobox/Sous-titre|Sous-titre 2}} {{Infobox/Géolocalisation multiple|géolocalisation=France|latitude=48.856578|longitude=2.351828}} {{Infobox/Notice|Infobox Pays}} {{Infobox/Fin}}
Programmation avec ajout de paramètres
modifierUsage des briques avec paramètres
modifierLa création d'un nouveau modèle à l'aide de briques implique obligatoirement l'ajout de paramètres comme {{Infobox/Image|{{{image|}}}}} et non plus {{Infobox/Image|defaut.svg}}.
Exemple de briques avec paramètres
modifierÉtape 1 - Création de la page du modèle
modifier<includeonly>{{Infobox/Début}} {{Infobox/Titre | {{{nom|{{PAGENAME}}}}}|E1E1E1|map }} {{Infobox/Image | {{{image|}}}|{{{légende|}}}|200 }} {{Infobox/Sous-titre | Géographie }} {{Infobox/Ligne mixte | Paramètre 1|{{{paramètre 1|}}} }} {{Infobox/Ligne mixte | Paramètre 2|{{{paramètre 2|}}} }} {{Infobox/Ligne mixte latitude longitude optionnelle | Coordonnées|{{{latitude|}}}|{{{longitude|}}}|city_region:FR|dms long }} {{Infobox/Séparateur }} {{Infobox/Ligne donnée | Paramètre 5|{{{paramètre 5|}}} }} {{Infobox/Ligne donnée | Paramètre 6|{{{paramètre 6|}}} }} {{Infobox/Sous-titre | Sous-titre 2 }} {{Infobox/Géolocalisation multiple |géolocalisation = France|latitude={{{latitude|}}}|longitude={{{longitude|}}}|largeur=260 }} {{Infobox/Notice | Infobox Pays }} {{Infobox/Fin}}</includeonly><noinclude>{{Documentation}}</noinclude>
Étape 2 - Création de la page de documentation
modifierÉtape 3 - Ajout du modèle dans les articles
modifier
Titre | ||
Vue de l'image ci-dessus | ||
Géographie | ||
---|---|---|
Paramètre 1 | ... | |
Paramètre 2 | ... | |
Coordonnées | 48° 51′ 24″ nord, 2° 21′ 07″ est | |
Paramètre 5 | ... | |
Paramètre 6 | ... | |
Sous-titre 2 | ||
Géolocalisation sur la carte : France
| ||
modifier |
{{Projet:Infobox/Didacticiel infobox avec des briques ex | nom = Titre | image = defaut.svg | légende = Vue de l'image ci-dessus | paramètre 1 = ... | paramètre 2 = ... | longitude = 2.351828 | latitude = 48.856578 | paramètre 5 = ... | paramètre 6 = ... }}