Aller au contenu

Projet:Infobox/Tutoriel infobox avec des briques

Une page de Wikipédia, l'encyclopédie libre.

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
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 | 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
Sa valeur Sa valeur
Sa valeur Sa valeur
Sous-titre 2
Géolocalisation sur la carte : France
(Voir situation sur 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]

Étape 3 - Ajout du modèle dans les articles

[modifier | modifier le code]

Titre
Image illustrative de l’article Infobox/Tutoriel infobox avec des briques
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
(Voir situation sur 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 = ...
}}