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
[modifier | modifier le code]Pour 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
[modifier | modifier le code]Afin 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
[modifier | modifier le code]Dans 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
[modifier | modifier le code]Il 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
[modifier | modifier le code]Veuillez 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
[modifier | modifier le code]Structure | 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
[modifier | modifier le code]Usage des briques sans paramètres
[modifier | modifier le code]Les 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 | modifier le code]
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
[modifier | modifier le code]Usage des briques avec paramètres
[modifier | modifier le code]La 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 | modifier le code]Étape 1 - Création de la page du modèle
[modifier | modifier le code]<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 | modifier le code]Étape 3 - Ajout du modèle dans les articles
[modifier | modifier le code]
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 = ... }}