Projet:Infobox/Didacticiel infobox modulaire

Introduction[]

Suivant les souhaits, une infobox V2 peut faire appel à plusieurs sous-modèles. Le code de l'infobox n'est donc plus centralisé sur une seule page mais sur plusieurs. La construction d'une infobox V2 modulaire consiste à encapsuler entre {{ }} tout ou partie du code d'une infobox dans un ou plusieurs sous-modèles. La création d'une infobox modulaire doit se justifier par des besoins réels auquel cas il sera préférable de créer une infobox non modulaire, comme la très grande majorité d'infobox existantes sur Aigles et Lys. Les infobox modulaires sont plus simples à protéger et à gérer. Les infobox modulaires sont surtout utiles pour des sujets scientifiques comme la biologie, la chimie...

Programmation[]

Création des modules[]

La création d'une infobox modulaire implique la création au minimum de 2 modules que sont le module principal suivi d'un ou de plusieurs modules complémentaires. Le module principal et son ou ses modules complémentaires seront toujours précédés du module générique {{Infobox modulaire/Début}} et suivi du module {{Infobox modulaire/Fin}}.

Module principal[]

Le module principal est celui qui porte le nom de l'infobox comme Infobox Protéine. Ce module comprend obligatoirement, au minimum, l'en-tête de l'infobox. Ainsi débutez par la création d'une page intitulée par exemple Modèle:Infobox Protéine. Ensuite ajoutez-y le script de l'en-tête suivi si besoin est des paramètres que vous aurez jugé utiles d'ajouter et qui seront génériques pour l'ensemble des articles concernés par cette infobox modulaire. Ensuite ajoutez-y une documentation qui servira de notice et qui citera au passage l'ensemble des modules complémentaires qui pourront être adjoints à ce module principal.

Ce qui sur la page donnera la chose suivante, avec un en-tête seul

<includeonly>! colspan="2" class="entete defaut" style="background-color:orange; color:#000000" | {{{nom|{{PAGENAME}}}}}
|-</includeonly><noinclude>{{Doc modèle}}</noinclude>

Ce qui sur la page donnera la chose suivante, avec un en-tête suivi de paramètres

<includeonly>! colspan="2" class="entete defaut" style="background-color:orange; color:#000000" | {{{nom|{{PAGENAME}}}}}
|-
! Paramètre 1
| {{{paramètre 1}}}
|-
! Paramètre 2
| {{{paramètre 2}}}
|-</includeonly><noinclude>{{Doc modèle}}</noinclude>

Module complémentaire[]

Les modules complémentaires portent le nom du module principal de l'infobox suivi de « /Nom module complémentaire » comme Infobox Protéine/Espèce. Ce module ne doit jamais contenir un en-tête, il peut contenir au mieux un sous-titre ou un trait de séparation (voir Infobox V2 Esthétique générale). Les modules complémentaires peuvent permettre l'ajout de nouveaux paramètres obligatoires ou facultatifs. Ainsi débutez par la création d'une page intitulée par exemple Modèle:Infobox Protéine/Espèce. Ensuite ajoutez-y le script avec, suivant vos souhaits, un ou plusieurs sous-titres, des traits de séparations ou des paramètres que vous aurez jugés utile d'ajouter. Ensuite ajoutez-y une documentation qui servira de notice et qui citera au passage le module principal qui doit obligatoirement être adjoint à ces modules complémentaires.

Ce qui sur la page donnera la chose suivante, avec un en-tête suivi de paramètres

<includeonly>! colspan="2" style="text-align:center;background-color:#dfffdd;color:#000000" |Espèce
|-
! Paramètre 1
| {{{paramètre 1}}}
|-
! Paramètre 2
| {{{paramètre 2}}}
|-
{{#if:{{{siteweb|}}} | 
! Site web
{{!}} <span class="plainlinks">[{{{siteweb}}} Consulter]</span>
{{!-}}
}}</includeonly><noinclude>{{Doc modèle}}</noinclude>

Syntaxe sur les articles[]

{{Infobox modulaire/Début}}
{{Infobox Protéine
 | paramètre1 = 
 | paramètre2 = 
 | paramètre3 = 
 | ...
}}
{{Infobox Protéine/module 1
 | paramètre1 = 
 | paramètre2 = 
 | paramètre3 = 
 | ...
}}
{{Infobox Protéine/module 2
 | paramètre1 = 
 | paramètre2 = 
 | paramètre3 = 
 | ...
}}
{{Infobox modulaire/Fin}}

Simplification des paramètres dans les modules[]

Suivant les cas, il se peut que le sujet d'une série d'articles comme les taxons exige l'ajout sur les articles concernés d'un nombre important de modules complémentaires. À titre exceptionnel, il est recommandé de simplifier les paramètres en leur attribuant un libellé numéraire. Cela permettra d'avoir sur les articles une syntaxe moins longue. Cette pratique doit demeurer exceptionnelle.

Ce qui sur la page donnera la chose suivante, avec un en-tête suivi de paramètres

<includeonly>! colspan="2" style="text-align:center;background-color:#dfffdd;color:#000000" |Espèce
|-
! Paramètre 1
| {{{1}}}
|-
! Paramètre 2
| {{{2}}}
|-
{{#if:{{{3|}}} | 
! Site web
{{!}} <span class="plainlinks">[{{{3}}} Consulter]</span>
{{!-}}
}}</includeonly><noinclude>{{Doc modèle}}</noinclude>

Sur les articles on aura alors

{{Infobox modulaire/Début}}
{{Infobox Protéine
 | paramètre1 = ...
 | paramètre2 = ...
 | paramètre3 = ...
 | ...
}}
{{Infobox Protéine/module 1| ... | ... | http://www.monsite.com | ... }}
{{Infobox Protéine/module 2| ... | ... | ... | ... }}
{{Infobox Protéine/module 3| ... | ... | ... | ... }}
{{Infobox Protéine/module 4| ... | ... | ... | ... }}
{{Infobox modulaire/Fin}}

Documentation[]

Documentation pour un module principal[]

La documentation du module principal doit présenter comme tout autre modèle d'infobox la syntaxe et les paramètres ainsi que donner un exemple. Mais cette page de documentation doit également répertorier tous les modules complémentaires pouvant être adjoints à ce module principal.

Au total on aura donc :

<noinclude>{{documentation modèle vue directement}}</noinclude>

Ce modèle d'[[Projet:Infobox/V2|infobox V2]] permet la mise en place d'une infobox dans tous les articles sur les [[protéine]]s. Ce modèle est à utiliser conjointement avec {{m|Infobox modulaire/Début}} et {{m|Infobox modulaire/Fin}}. 

== Syntaxe ==

Voici la syntaxe à copier-coller sur les articles :

<pre><nowiki>
{{Infobox modulaire/Début}}
{{Infobox Protéine
 | paramètre1 = 
 | paramètre2 = 
 | paramètre3 = 
 | ...
}}
{{Infobox Protéine/module 1
 | paramètre1 = 
 | paramètre2 = 
 | paramètre3 = 
 | ...
}}
{{Infobox Protéine/...
 | paramètre1 = 
 | paramètre2 = 
 | paramètre3 = 
 | ...
}}
{{Infobox modulaire/Fin}}
</nowiki></pre>

== Paramètres ==

* '''paramètre1''' : Description ...
* '''paramètre2''' : Description ...
* '''paramètre3''' : Description ...

== Exemple ==

{{Infobox modulaire/Début}}
{{Infobox Protéine
 | paramètre1 = ...
 | paramètre2 = ...
 | paramètre3 = ...
 | ...
}}
{{Infobox modulaire/Fin}}
<pre><nowiki> 
{{Infobox modulaire/Début}}
{{Infobox Protéine
 | paramètre1 = ...
 | paramètre2 = ...
 | paramètre3 = ...
 | ...
}}
{{Infobox modulaire/Fin}}
</nowiki></pre> 
{{clr}}

== Modules complémentaires ==
* {{m|Infobox Protéine/module 1}}
* {{m|Infobox Protéine/module 2}}

== Voir aussi ==
* [[Projet:Infobox/Didacticiel infobox modulaire|Didacticiel infobox modulaire]]

{{Projet infobox}}

<includeonly>

[[Catégorie:Modèle infobox modulaire V2]]
[[Catégorie:...]]

[[es:...]]
[[eo:...]]

</includeonly>

Documentation pour un module complémentaire[]

La documentation d'un module complémentaire doit présenter comme tout autre modèle d'infobox la syntaxe et les paramètres ainsi que donner un exemple. Mais cette page de documentation doit également citer le module principal associé. Un module complémentaire ne doit jamais être utilisé seul. Il sera toujours utilisé à la suite d'un module principal.