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

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

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

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

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

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
Liste exhaustive des modèles de briques existants
Structure Lignes de tableau Divers
Ouvertures et fermetures
Titres et sous-titres
Séparateurs
Ligne mixte
Ligne donnée
Ligne autre
Cartes
Images
Navigation
Ces modèles étant très utilisés ils sont protégés en écriture.

Programmation sans ajout de paramètres

modifier

Usage des briques sans paramètres

modifier

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

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

Usage des briques avec paramètres

modifier

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

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