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.
~~Modèle:Nom de l'infobox~~	Toujours commencer avec le mot « Infobox ».
~~Modèle:Infobox nom de l'infobox~~	Toujours débuter le nom de l'infobox avec une capitale.
~~Modèle:Infobox Nom De L'InfoBox~~	Ne pas mettre d'autres capitales dans le nom du modèle, sauf pour les noms propres.
~~Modèle:Infobox Nom infobox~~	Ne pas tronquer des mots, faire une phrase. Mieux vaut un nom de modèle clair qu'un nom trop court.
~~Modèle:Infobox Name of the infobox~~	Éviter des mots anglophones. Ex : Comicbook, podcast, TV, etc.
~~Modèle:Infobox Nom du modele~~	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 « = ».

À faire

À éviter

{{Infobox Nom de l'infobox
 | nom     = 
 | image   = 
 | légende = 
 | autre   = 
}}

{{Infobox Nom de l'infobox|
nom     =|
image   =|
légende =|
autre   =|
}}

{{Infobox Nom de l'infobox
nom =
image =
légende =
autre =
}}

{{Infobox Nom de l'infobox
|nom= 
|img= 
|lég= 
|aut= 
}}

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]

**Liste exhaustive des modèles de briques existants**
Structure		Lignes de tableau		Divers
Ouvertures et fermetures {{Infobox/Début}} {{Infobox/Notice}} {{Infobox/Fin}} Titres et sous-titres {{Infobox/Titre}} {{Infobox/Titre avec icône}} {{Infobox/Sous-titre}} {{Infobox/Sous-titre optionnel}} Séparateurs {{Infobox/Séparateur}} {{Infobox/Séparateur optionnel}} {{Infobox/Séparateur optionnel non}}		Ligne mixte {{Infobox/Ligne mixte}} {{Infobox/Ligne mixte optionnelle}} {{Infobox/Ligne mixte valeurs multiples}} {{Infobox/Ligne mixte valeurs multiples optio...}} {{Infobox/Ligne mixte site web optionnelle}} {{Infobox/Ligne mixte latitude longitude}} {{Infobox/Ligne mixte latitude longitude optio...}} {{Infobox/Ligne mixte densité optionnelle}} Ligne donnée {{Infobox/Ligne donnée}} {{Infobox/Ligne donnée optionnelle}} {{Infobox/Ligne donnée valeurs multiples}} {{Infobox/Ligne donnée valeurs multiples optio...}} Ligne autre {{Infobox/Ligne}} {{Infobox/Ligne optionnelle}}		Cartes {{Infobox/Géolocalisation multiple}} {{Infobox/Carte dynamique}} Images {{Infobox/Image}} {{Infobox/Image optionnelle}} {{Infobox/Image double}} Navigation {{Infobox/Succession}} {{Infobox/Éphéméride}}

Ces modèles étant très utilisés ils sont protégés en écriture.

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

Image illustrative de l’article Infobox/Tutoriel infobox avec des briques

Sous-titre 1

Nom du champ

Sa valeur

Nom du champ

Sa valeur

Nom du champ

Sa valeur

Sous-titre 2

Géolocalisation sur la carte : France

{{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]

Article détaillé : Aide:Documentation de modèle.

É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

{{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 = ...
}}

Voir aussi[modifier | modifier le code]

Projet Infobox