Projet:Infobox/V1 Débutant

Ce tutoriel explique comment construire une infobox V1.
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.

Réalisation par étapes

Étape 1 - Création de la page

Créez une page intitulée Modèle:Infobox Nom du thème. Il faut toujours mettre le mot Infobox au début avec une majuscule ainsi que le second mot qui suit. Si le titre de l'infobox comporte un nom propre alors celui-ci doit comporter une majuscule comme par exemple Modèle:Infobox France.

• Ce qu'il faut faire :

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.

• 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 2 - 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 ---------------------------------->
|}

Paramètres obligatoires

Dans la partie 2 du tableau, on peut ajouter un ou plusieurs paramètres obligatoires. Ceux-ci apparaîtront en permanence même si on ne les remplit pas. Ils sont permanents. Pour ajouter un paramètre 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}}}
|}

Paramètres facultatifs

Dans la partie 2 du tableau, on peut ajouter un ou plusieurs paramètres facultatifs. Ceux-ci apparaîtront uniquement si l'on remplit la valeur des paramètres dans les articles. Sinon, ils n'apparaîtront pas dans l'article. Pour ajouter un paramètre 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}}}}}
|}

Étape 3 - 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}}}}}
|}

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 cete 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 suivant :

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

Il permet de relier la page de documentation au modèle d'infobox correspondant.

Syntaxe

La syntaxe 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 la syntaxe à 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 cette même syntaxe mais remplie 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}}

== Syntaxe ==
Voici la syntaxe à 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 paramètres. 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}}
== Syntaxe ==
Voici la syntaxe à 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

Tout 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 souci esthétique et une meilleure 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}}
== Syntaxe ==
Voici la syntaxe à 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}}
== Syntaxe ==
Voici la syntaxe à 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.

Exemples

• Page de l'infobox :

  {{Projet:Infobox/V1 Débutant/Infobox exemple}}

• Page de sa documentation :

  Modèle:Projet:Infobox/V1 Débutant/Infobox exemple/Documentation