Projet:Infobox/V1

Ce tutoriel explique comment construire une infobox V1. Il ne s'agit que d'un exemple. Car un modèle est défini comme étant une infobox V1 toute infobox qui n'est pas une infobox V2.
Attention, suivant la généricité de l'infobox, il peut être préférable de réaliser une Infobox V2 qui permet une meilleure harmonisation des modèles d'infobox. Les Infobox V1 sont recommandées pour les sujets d'articles pouvant être particuliers et dont il est préférable de produire un modèle spécifique et non générique. Si vous débutez dans la création d'infobox, nous vous conseillons de lire, dans un premier temps, la page Projet:Infobox/V1 Débutant.

Réalisation par étapes

Étape 1 - Travail préparatoire

Avant de vous lancer dans la création d'une infobox, prenez le temps de vérifier si une infobox déjà existante ne pourrait pas convenir pour vos besoins. Ensuite prenez connaissance des conseils généraux issus du Projet:Charte graphique portant sur l'apparence des Infobox. Pour se faire rendez-vous sur le lien Projet:Charte graphique/Apparence des Infobox.

Étape 2 - Création de la page

Créez une page intitulée Modèle:Infobox Nom du thème comme par exemple Modèle:Infobox France.

• Ce qu'il faut faire :

Modèle:Infobox Nom de l'infobox ; Toujours «Infobox» au début, et une majuscule au Nom de l'infobox. Ne pas tronquer de mots.

• Ce qu'il ne faut pas faire :

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 majuscule.

Modèle:Infobox Nom De L'InfoBox ; Ne pas mettre d'autres majuscules dans le nom du modèle, sauf pour les noms propres.

Modèle:Infobox Nom infobox ; Ne pas tronquer des mots, faire une phrase. Vaut mieux 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 ...

Modèle:Infobox Nom du modele ; Toujours utiliser les accents pour un titre.

Étape 3 - programmation

Une fois la page créée correctement, il vous reste à programmer un modèle d'infobox.

Structure tripartite

Un modèle d'infobox consiste en la mise en place d'un tableau composé de trois parties qui sont :

<!---------------------------------- Partie 1 ---------------------------------->
{| class="infobox"

<!---------------------------------- Partie 2 ---------------------------------->
! colspan="2" style="background-color: #B2D55F; font-size: larger; text-align: center;" | <font size="4">'''{{{nom}}}'''</font>
|-
!  style="background: orange"|Pays
| style="background: orange"|{{{pays}}}
|-
{{#if: {{{taille|}}} | 
! scope=row style="background-color: orange;" {{!}} Taille du jardin
{{!}} style="background-color: orange;" {{!}}  {{{taille}}}}}

<!---------------------------------- Partie 3 ---------------------------------->
|}

Champs fixes

Présentation

Dans la partie 2 du tableau, on peut ajouter un ou plusieurs champs fixes. Ceux-ci apparaîtront en permanence dans l'infobox et ne sont pas modifiables depuis les articles mais uniquement depuis la page du modèle de l'infobox. Pour ajouter un champ fixe dans l'infobox, vous devez ajouter dans la partie 2 l'un des champs cités en exemple ci-dessous.

Liste de champs types

Voici ci-dessous une liste de champs fixes types pouvant être utilisés pour la création d'une infobox.

1 - Sous-titre, il permet l'ajout d'un ou de plusieurs sous-titre.

|-
| colspan="2" style="background-color: #B2D55F; color:black;font-size:larger;"| '''Le Sous-titre'''

2 - Pied avec Tnavbar, il permet l'ajout d'un pied d'infobox avec la présence du modèle {{Tnavbar}}. (voir exemple)

|-
| colspan="2" style="background: #FFFFFF"|<small>[[Jardin]] - [[:Catégorie:jardin|Liste des jardins]] {{!}} {{Tnavbar|Infobox jardin|nodiv=1|mini=1}}</small>

Champs obligatoires

Présentation

Dans la partie 2 du tableau, on peut ajouter un ou plusieurs champs obligatoires. Ceux-ci apparaîtront en permanence même si on ne les remplit pas. Ils sont permanents. Pour ajouter un champ obligatoire dans l'infobox, vous devez ajouter dans la partie 2 le script suivant :

<!---------------------------------- Partie 2 ---------------------------------->
|-
!  style="background: orange"|Pays
| style="background: orange"|{{{pays}}}

Le modèle complet sera alors celui-ci :

{| class="infobox"
! colspan="2" style="background-color: #B2D55F; font-size: larger; text-align: center;" | <font size="4">'''{{{nom}}}'''</font>
|-
!  style="background: orange"|Pays
| style="background: orange"|{{{pays}}}
|-
!  style="background: orange"|Région
| style="background: orange"|{{{region}}}
|-
| colspan="2" style="background: #FFFFFF"|<small>[[Jardin]] - [[:Catégorie:jardin|Liste des jardins]] {{!}} {{Tnavbar|Infobox jardin|nodiv=1|mini=1}}</small>
|}

Liste de champs types

Voici ci-dessous une liste de champs obligatoires types pouvant être utilisés pour la création d'une infobox.

1 - Champ image simple, il permet l'ajout d'une image faisant la largeur de l'infobox accompagnée de sa légende qui est quant à elle facultative.

|-
| colspan="2" style="padding: 0 0 0 0;background-color: #ffffff;" | [[Image:{{{image}}}|290px]] {{#if:{{{légende|}}}|<br /><small>{{{légende|}}}</small>}}

Les paramètres ajouté sont image et légende :

{{Infobox jardin
 | nom     = Jardin d'Europe
 | image   = photodujardin.jpg
 | légende = <!-- facultatif ou Vue du jradin en été -->
 | pays    = 
 | taille  = <!-- facultatif -->
}}

Champs facultatifs

Présentation

Dans la partie 2 du tableau, on peut ajouter un ou plusieurs champs facultatifs. Ceux-ci apparaîtront uniquement si l'on remplit la valeur des champs dans les articles. Sinon, ils n'apparaîtront pas dans l'article. Pour ajouter un champ facultatif dans l'infobox, vous devez ajouter dans la partie 2 le script suivant :

<!---------------------------------- Partie 2 ---------------------------------->
|-
{{#if: {{{taille|}}} | 
! scope=row {{!}} Taille du jardin
{{!}} style="background-color: orange;" {{!}}  {{{taille}}}}}

Le modèle complet sera alors celui-ci :

{| class="infobox"
! colspan="2" style="background-color: #B2D55F; font-size: larger; text-align: center;" | <font size="4">'''{{{nom}}}'''</font>
|-
{{#if: {{{taille|}}} | 
! scope=row style="background-color: orange;" {{!}} Taille du jardin
{{!}} style="background-color: orange;" {{!}}  {{{taille}}}}}
|-
| colspan="2" style="background: #FFFFFF"|<small>[[Jardin]] - [[:Catégorie:jardin|Liste des jardins]] {{!}} {{Tnavbar|Infobox jardin|nodiv=1|mini=1}}</small>
|}

Liste de champs types

Voici ci-dessous une liste de champs facultatifs types pouvant être utilisés pour la création d'une infobox.

1 - Champ image simple, il permet l'ajout d'une image faisant la largeur de l'infobox accompagnée de sa légende qui est quant à elle facultative.

|- 
{{#if:{{{image|}}}|
{{!}} colspan="2" style="padding: 0 0 0 0;background-color: #ffffff;" {{!}} [[Image:{{{image}}}|290px]] {{#if:{{{légende|}}}|<br /><small>{{{légende|}}}</small>}} }}

Les paramètres ajouté sont image et légende :

{{Infobox jardin
 | nom     = Jardin d'Europe
 | image   = <!-- facultatif ou photodujardin.jpg -->
 | légende = <!-- facultatif ou Vue du jradin en été -->
 | pays    = 
 | taille  = <!-- facultatif -->
}}

Étape 4 - Documentation

Le modèle de l'infobox étant à présent codé, il reste à ajouter une documentation afin de présenter et d'expliquer son usage.

Création

Pour créer une documentation vous devez ajouter, juste avant l'infobox, le script suivant :

<noinclude>{{{{FULLPAGENAME}}/Documentation}}</noinclude>

Ce qui sur la page donnera la chose suivante :

<noinclude>{{{{FULLPAGENAME}}/Documentation}}</noinclude>
{| class="infobox"
! colspan="2" style="background-color: #B2D55F; font-size: larger; text-align: center;" | <font size="4">'''{{{nom}}}'''</font>
|-
!  style="background: orange"|Pays
| style="background: orange"|{{{pays}}}
|-
{{#if: {{{taille|}}} | 
! scope=row style="background-color: orange;" {{!}} Taille du jardin
{{!}} style="background-color: orange;" {{!}}  {{{taille}}}}}
|-
| colspan="2" style="background: #FFFFFF"|<small>[[Jardin]] - [[:Catégorie:jardin|Liste des jardins]] {{!}} {{Tnavbar|Infobox jardin|nodiv=1|mini=1}}</small>
|}

Un lien rouge apparaîtra au sommet de la page de votre modèle d'infobox. Il vous suffira alors de cliquer dessus afin de créer la page de documentation. Une fois cette page de documentation créée, il vous reste à y ajouter son contenu.

Contenu

Pour l'essentiel sur la page de documentation, on y ajoute cinq informations principales que sont :

Bandeau documentation

La première chose que l'on doit ajouter en haut de la page de documentation est le script qui permet de relier la page de documentation au modèle d'infobox correspondant. Il existe plusieurs bandeau suivant la nature de l'infobox. Vous pouvez utiliser l'un des scripts ci-dessous :

1 - Bandeau basique, c'est le bandeau que l'on utilise par défaut.

{{Documentation modèle en sous-page}}

2 - Bandeau ParserFunctions, c'est le bandeau que l'on utilise lorsque l'infobox utilise les ParserFunctions.

{{Documentation modèle utilisant les ParserFunctions en sous-page}}

Modèle

Le modèle que les utilisateurs devront copier-coller sur les articles doit respecter un certains formalisme. Si l'infobox que l'on crée s'appelle Modèle:Infobox jardin le modèle à ajouter sur les articles sera ci-dessous :

<pre><nowiki> 
{{Infobox jardin
 | nom    = 
 | pays   = 
 | taille = <!-- facultatif -->
}}
</nowiki></pre> 

Puis juste en dessous de cet exemple que l'on mettra sur la page de documentation, on ajoutera également un exemple de ce même modèle mais rempli comme l'exemple ci-dessous :

<pre><nowiki> 
{{Infobox jardin
 | nom    = Jardin d'Europe
 | pays   = France
 | taille = 200 m²
}}
</nowiki></pre> 

Au total on aura donc :

{{Documentation modèle en sous-page}}

== Modèle ==
Voici le modèle à copier-coller sur les articles :
<pre><nowiki>
{{Infobox jardin
 | nom    = 
 | pays   = 
 | taille = <!-- facultatif -->
}}
</nowiki></pre>

Voici un exemple :
<pre><nowiki>
{{Infobox jardin
 | nom    = Jardin d'Europe
 | pays   = France
 | taille = 200 m²
}}
</nowiki></pre>

Mode d'emploi

Ensuite on doit ajouter un mode d'emploi, afin d'expliquer ce que l'on doit mettre dans chacun des champs. Ainsi on doit ajouter une nouvelle section comme l'exemple ci-dessous :

== Mode d'emploi ==
* '''nom''' : Il sert à indiquer le nom du jardin...
* '''pays''' : Il sert à indiquer dans quel pays se trouve le jardin...
* '''taille''' : Il sert à donner la taille en mètre carré du jardin...

Au total on aura donc :

{{Documentation modèle en sous-page}}
== Modèle ==
Voici le modèle à copier-coller sur les articles :
<pre><nowiki>
{{Infobox jardin
 | nom    = 
 | pays   = 
 | taille = <!-- facultatif -->
}}
</nowiki></pre> 

Voici un exemple :
<pre><nowiki>
{{Infobox jardin
 | nom    = Jardin d'Europe
 | pays   = France
 | taille = 200 m²
}}
</nowiki></pre>

== Mode d'emploi ==
* '''nom''' : Il sert à indiquer le nom du jardin...
* '''pays''' : Il sert à indiquer dans quel pays se trouve le jardin...
* '''taille''' : Il sert à donner la taille en mètre carré du jardin...

Rendu dans les articles

Tous le contenu de cette page de documentation apparaîtra également automatiquement en haut de la page du modèle de l'infobox correspondant. Ainsi, dans un soucis esthétique et une meilleurs lisibilité de la page de l'infobox, on ajoute une nouvelle section, seule et sans contenu, intitulée Rendu dans les articles. En effet le contenu est déjà présent sur la page du modèle donc inutile de le remettre sur la page de documentation. Donc voici un exemple de ce que vous devrez rajouter sur la page de documentation :

== Rendu dans les articles ==

Au total on aura donc :

{{Documentation modèle en sous-page}}
== Modèle ==
Voici le modèle à copier-coller sur les articles :
<pre><nowiki>
{{Infobox jardin
 | nom    = 
 | pays   = 
 | taille = <!-- facultatif -->
}}
</nowiki></pre>

Voici un exemple :
<pre><nowiki>
{{Infobox jardin
 | nom    = Jardin d'Europe
 | pays   = France
 | taille = 200 m²
}}
</nowiki></pre>

== Mode d'emploi ==
* '''nom''' : Il sert à indiquer le nom du jardin...
* '''pays''' : Il sert à indiquer dans quel pays se trouve le jardin...
* '''taille''' : Il sert à donner la taille en mètre carré du jardin...

== Rendu dans les articles ==

Catégorie

Pour finir la page de documentation, il vous reste à ajouter la ou les catégories adéquates afin de pouvoir classer votre infobox. Pour trouver une catégorie, vous pouvez aller sur Catégorie:Modèle infobox. L'ajout de catégorie se fait en bas de la page de documentation du modèle de l'infobox et non directement sur la page de l'infobox. Sur la page de documentation vous devez mettre les catégories entre <includeonly></includeonly> autrement si vous ne le faites pas, alors tous les articles qui seront dotés de votre infobox seront catégorisés au même titre que votre infobox. Donc voici ce que vous devez ajouter en bas de page de la documentation :

<includeonly>
[[Catégorie:Modèle infobox]]
[[Catégorie:...]]
</includeonly>

Au total on aura donc :

{{Documentation modèle en sous-page}}
== Modèle ==
Voici le modèle à copier-coller sur les articles :
<pre><nowiki>
{{Infobox jardin
 | nom    = 
 | pays   = 
 | taille = <!-- facultatif -->
}}
</nowiki></pre>

Voici un exemple :
<pre><nowiki>
{{Infobox jardin
 | nom    = Jardin d'Europe
 | pays   = France
 | taille = 200 m²
}}
</nowiki></pre>

== Mode d'emploi ==
* '''nom''' : Il sert à indiquer le nom du jardin...
* '''pays''' : Il sert à indiquer dans quel pays se trouve le jardin...
* '''taille''' : Il sert à donner la taille en mètre carré du jardin...

== Rendu dans les articles ==
<includeonly>
[[Catégorie:Modèle infobox]]
[[Catégorie:...]]
</includeonly>

Voilà à présent vous pouvez créer des infobox V1.