Projet:Infobox/Didacticiel infobox modulaire

Introduction

Suivant les cas, une infobox peut faire appel à plusieurs sous-modèles. Le code de l'infobox n'est donc plus centralisé sur une seule page mais réparti sur plusieurs. La construction d'une modulaire consiste à encapsuler entre {{ }} tout ou partie du code d'une infobox dans un ou plusieurs sous-modèles.

Avantages : 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... Elles sont par ailleurs compatibles avec les bonnes pratiques d'accessibilité.

Infobox utilisant une construction modulaire

Infobox V2

En ce qui concerne la génération des infobox de type infobox V2, la création d'une infobox modulaire doit se justifier par des besoins réels, dans le cas contraire il sera préférable de créer une infobox non modulaire.^{[Passage à actualiser]}

Infobox V3

Les infobox V3 corrigent des problèmes de sémantique et d'accessibilité au Web. Elles sont prévues pour être en accord avec les bonnes pratiques d'accessibilité puisque les tableaux ne sont utilisés que pour les seules données réellement concernées et la gestion des images est faite sous forme de vignette (thumb).

Les taxobox de biologie sont notamment construites sur la base des infobox V3.

Programmation

Création des modules

La création d'une infobox modulaire implique la création au minimum de deux 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é utile 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é 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.

Au total on aura donc :

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

Ce modèle permet la mise en place d'un module dans une infobox modulaire dans certains articles sur les [[protéine]]s. Ce modèle est à utiliser conjointement avec {{m|Infobox modulaire/Début}}, {{m|Infobox Protéine}} 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 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 Protéine/module 1
 | 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 Protéine/module 1
 | paramètre1 = ...
 | paramètre2 = ...
 | paramètre3 = ...
 | ...
}}
{{Infobox modulaire/Fin}}
</nowiki></pre> 
{{clr}}

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

Projet Infobox