Fr:Projet:Infobox/V2

Predefinição:Page méta archivée

Voir Projet:Infobox/Didacticiel infobox avec des briques .
Les **infobox standard**, ou appelées aussi « V2 », améliorent l'aspect, la simplicité et la flexibilité des infoboxes de Wikipédia. L'intérêt est d'harmoniser l'apparence par des feuilles de style en cascade, des pictogrammes thématiques, une simplification du code ainsi que la possibilité de généricité qui consiste à fusionner plusieurs modèles en un seul ; autrement dit, utiliser le moins de ressources possible et obtenir un produit harmonisé. Pour plus d'information ou pour faire une demande de fabrication, voir la page de discussion.

Aussi disponibles pour aider, voir les quelques **exemples d'infobox standard déjà en ligne**.

thumb|upright=1.5|Charte graphique des Infobox V2 pour les jeux vidéo avec les fonctions du parseur

## Conventions d'harmonisation

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

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 :

* Predefinição:Bleu (avec « Infobox » au début, et une majuscule au Nom de l'infobox. Ne pas tronquer de mots.)
* ~~Predefinição:Rouge~~ (Toujours commencer avec le mot « Infobox ».)
* ~~Predefinição:Rouge~~ (Toujours débuter le nom de l'infobox avec une capitale.)
* ~~Predefinição:Rouge~~ (Ne pas mettre d'autres capitales dans le nom du modèle, sauf pour les noms propres.)
* ~~Predefinição:Rouge~~ (Ne pas tronquer des mots, faire une phrase. Mieux vaut un nom de modèle clair qu'un nom trop court.)
* ~~Predefinição:Rouge~~ (Éviter des mots anglophones. Ex : Comicbook, podcast, TV, etc.)
* ~~Predefinição:Rouge~~ (Toujours utiliser les accents pour un titre.)

En outre, les images qui habillent l'en-tête ont leurs propres conventions de nomenclature, à savoir le titre, les dimensions, l'apparence, etc. Voir les pictogrammes plus loin.

### Paramétrage

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* « = ».

```
{{Infobox Nom de l'infobox
}}

```
```
}}

```
```
{{Infobox Nom de l'infobox
}}

```

## Programmation des modèles

**Predefinição:Rouge**, 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 Predefinição:M pour un exemple de sous-page d'infobox générique) ;
* évitez de faire apparaître les paramètres non renseignés.

#### Exemple type de programmation

Toutes les infobox se composent de deux parties que sont l'en-tête et le contenu.

* **L'en-tête** (ou *head*), constitué d'un rectangle épais dont la couleur est modulable. L'en-tête contient le titre de l'infobox, qui est l'élément le plus important et que l'internaute doit repérer et appréhender d'un seul coup d'œil. Ce rectangle contient un pictogramme personnalisé (voir les pictogrammes existants), fonction du domaine de l'infobox (des notes pour le domaine de la musique, une pellicule pour le domaine du cinéma...). La couleur de l'en-tête ainsi que le pictogramme servent à établir une charte graphique pour un domaine donné.

Exemple d'un en-tête par défaut :

```
! colspan="2" class="entete defaut" style="background-color:orange;color:#000000" | {{{nom|{{PAGENAME}}}}}

```

* **Le contenu**, qui peut contenir des sous-titres éventuels (rectangles colorés moins denses que l'en-tête) et les informations à proprement parler. Pour un aspect moderne et sobre, le texte est ferré (aligné) à gauche et il est graissé (en gras) dans la colonne de gauche. Les traits de séparations, si possible non colorisés, sont restreints en n'étant utilisés que pour séparer les grandes classes d'informations.

Exemple d'un sous-titre obligatoire :

```
! colspan="2" style="text-align:center;background-color:#dfffdd;color:#ffffff" | Démographie

```

Exemple d'un sous-titre optionnel :

```
! colspan="2" style="text-align:center;background-color:#dfffdd;color:#ffffff" {{!}} Démographie
{{!-}}
}}

```

Exemple d'une ligne mixte obligatoire :

```
! scope=row | Paramètre 1

```

Exemple d'une ligne mixte optionnelle :

```
! scope=row {{!}} Paramètre 1
{{!}} {{{paramètre 1|}}}
{{!-}}
}}

```

Exemple d'un trait de séparation obligatoire :

```
! colspan="2" | <hr />

```

Exemple d'un trait de séparation optionnel :

```
{{!}} colspan="2" {{!}} <hr />
{{!-}}
}}

```

Exemple d'un modèle d'infobox

```
{| class="infobox_v2" cellspacing="7"
{{!-}}
}}
! scope=row {{!}} Paramètre 1
{{!}} {{{paramètre 1|}}}
{{!-}}
}}
! scope=row {{!}} Paramètre 2
{{!}} {{{paramètre 2|}}}
{{!-}}
}}

```

#### Mise à jour d'une programmation

Afin de mettre à jour une ancienne infobox, il faut considérer trois aspects avec attention : la généricité de l'infobox (fusion), le(s) nouveau(x) nom(s) de(s) modèle(s) et les nouveaux paramètres.

Étape 1 - Considérer la généricité (la fusion)
* Avant de mettre à jour une ancienne infobox, demandez-vous si d'autres infoboxes pourraient partager les mêmes paramètres et fusionner ensemble. Avec une charte, vous pourrez différencier les déclinaisons et imposer la charte voulue suivant le thème. Exemple des paramètres avec le cinéma (film) : *nom*, *titre*, *film* peuvent tous partager le même paramètre : *titre*.
* Une fois les infobox similaires identifiées, rassembler les paramètres fusionnés dans le codage. Ici, nous fusionnons *titre* et *film* sous « nom », *photo* sous « image », *vieux* et *ancien* sous « paramètre ». Cette technique aura pour effet de rediriger toutes les anciennes infoboxes vers la nouvelle et que tous les paramètres puissent être pris en compte.

```
{| class="infobox_v2" cellspacing="7"
! colspan="2" style="text-align:center;" {{!}} {{{photo|{{{image|}}}}}}
{{!-}}
}}
! scope=row {{!}} Paramètre 1
{{!}} {{{vieux 1|{{{ancien 1|{{{paramètre 1|}}}}}}}}}
{{!-}}
}}
<!------------------------------------------------------------------------------------
 Pour faciliter le repérage ultérieur par les robots, vous pouvez ajouter « déprécié »
------------------------------------------------------------------------------------->
! scope=row {{!}} Paramètre 2
{{!}} <!--déprécié-->{{{vieux 2|{{{ancien 2|<!---->{{{paramètre 2|}}}}}}}}}
{{!-}}
}}
! scope=row {{!}} Paramètre 3
{{!}} <!--déprécié-->{{{ancien 3|<!---->{{{paramètre 3|}}}}}}
{{!-}}
}}

```

Étape 2 - Considérer le(s) nouveau(x) nom(s) de(s) modèle(s)
* Pour des raisons d'allégement et d'ordre alphabétique dans l'espace de noms Modèle, il est fortement conseillé de choisir des noms qui respectent non seulement les conventions d'harmonisation, mais aussi une logique alphabétique. Par exemple, pour remplacer les anciennes infoboxes *Films*, *Métrages*, *Acteurs*, *Cinéma*, *Ciné-caméras*, *Ciné-projecteur* :

Predefinição:Bleu (pour définir la charte des couleurs entre les infobox)
Predefinição:Bleu (fusion des infobox *Métrages*, *Films*, *Films documentaires*, *Films musicaux*)
Predefinição:Bleu (fusion des infobox *Acteurs*, *Actrices*, *Doublures*, *Producteurs*, *Réalisateurs*, etc.)
Predefinição:Bleu (fusion des infobox *Cinémas*, *Cinéparcs*, *Cinéplex*, etc.)
Predefinição:Bleu
Predefinição:Bleu
Étape 3 - Requête d'implantation par un robot
* Lorsque les anciens paramètres ont été fusionnés dans les nouvelles infobox, il est possible de rediriger les modèles obsolètes vers la nouvelle infobox. Si tous les anciens paramètres ont bien été intégrés, l'implantation de la nouvelle infobox peut être faite sans erreurs de paramétrage.
* Finalement, une requête à un robot peut être faite. Pour ce faire, il faut fournir au dresseur de bot les anciens / nouveaux paramètres et le nom des anciennes / nouvelles infobox. Pour cette étape, Educa33 e est passé maître dans l'art d'implanter ces changements.

#### Autres considérations

Voici d'autres conseils en rafale pour hamoniser les infobox V2.

##### Liens de documentation et de modification

Bien qu'il n'existe pas de règles qui imposent l'ajout de liens dans les infobox permettant de consulter la documentation ou d'accéder directement à la page de programmation du modèle, il est cependant possible d'utiliser le modèle Predefinição:M. Pour les infobox de longues tailles, l'ajout de ce modèle dans l'infobox n'est pas systématique. Pour ce qui est de la couleur, il est recommandé d'utiliser la couleur AAAAAA, qui est la même couleur utilisée pour les traits de séparation. Pour inclure ces liens dans une infobox, ajoutez le code suivant :

```
{{Infodoc|colspan=2|couleur=AAAAAA|lien=Infobox Nom de l'infobox}}

```

##### Paramètre image

Predefinição:Article détaillé

Exemple d'un paramètre image optionnel avec une taille formatée et son paramètre légende :

```
! colspan="2"  align="center" {{!}}
{{!-}}
}}

```

Exemple d'un paramètre image optionnel avec une taille formatée, son paramètre légende et un lien d'ajout d'image par défaut :

```

```

Exemple d'un paramètre image optionnel dont la taille n'est pas formatée et son paramètre légende :

```
{{!-}}
}}

```

Exemple d'un paramètre image optionnel dont la taille n'est pas formatée mais dont une valeur plafond maximale (dans l'exemple 220 pixels) est imposée, et son paramètre légende :

```
{{!-}}
}}

```

##### Paramètre site Web

Suivant les situations, on souhaite parfois ajouter un paramètre *site web*. Il s'agit ici de renseigner sur le site officiel du sujet de l'article et uniquement de celui-ci. En aucun cas, ce paramètre ne doit remplacer la section *Liens externes* de l'article. Le paramètre site web doit toujours être facultatif. Pour inclure un paramètre site Web dans une infobox, ajoutez le code suivant :

```
! scope=row {{!}} Site Internet
{{!}} <span class="plainlinks">[{{{site web}}} Site officiel]</span>
{{!-}}
}}

```

##### Paramètre de géolocalisation

Il existe de nombreux systèmes de géolocalisation pouvant être inclus dans les infobox. La mise en place d'une géolocalisation peut se faire de différentes façons. Suivant les situations, vous pouvez notamment mettre en place une géolocalisation double ; pour en savoir plus, voir Aide:Tutoriel de géolocalisation double. À présent, voici un exemple par étapes, où l'on fait appel dans l'infobox à un autre modèle qui est Predefinição:M. Cet exemple n'en est qu'un parmi d'autres.

Étape 1 - Trouver un modèle de géolocalisation
Pour mettre en place votre géolocalisation, vous devez d'abord chercher s'il existe un modèle de géolocalisation pour l'espace géographique qui vous intéresse. Pour se faire, vous pouvez consulter la Catégorie:Modèle de paramétrage de carte ou encore par exemple Catégorie:Modèle de paramétrage de carte de pays... Si aucun modèle de géolocalisation pour un lieux précis n'existe alors vous devrez pralablement faire une demande de création de modèle de géolocalisation au Projet:Cartographie.

Étape 2 - Création des paramètres longitude et latitude
Sur le modèle d'infobox, vous devez ajouter deux nouveaux paramètres que vous pouvez appeler respectivement « longitude » et « latitude ». Ceux-ci permettront l'ajout en décimal des longitude et latitude d'un lieu afin de le situer géographiquement. Pour ce faire, ajoutez par exemple l'un des paramètres suivants dans votre infobox :

Exemple d'un paramètre obligatoire :

```
! scope=row | [[Coordonnées géographiques|Coordonnées]]

```

Exemple d'un paramètre optionnel :

```
! scope=row {{!}} [[Coordonnées géographiques|Coordonnées]]
{{!-}}
}}}}

```

Étape 2 - Inclusion du modèle de géolocalisation
À présent, il ne reste plus qu'à inclure le modèle de géolocalisation Predefinição:M, dans l'infobox. Pour ce faire, vous pouvez, par exemple, ajouter le paramètre suivant :

```
{{#if: {{#ifexpr: {{{latitude}}} AND {{{longitude}}} }} | | {{!}}-
{{!}} colspan="2" align="center" style="padding: 1 1 1 1;" {{!}}
{{!-}}
}}

```

Voilà à présent votre infobox dispose d'un système de géolocalisation automatisé. Si les paramètres longitudes et latitudes ne sont pas remplis alors aucune carte de géolocalistaion n’apparaîtra dans l'infobox.
Predefinição:Boîte déroulante/fin

### Programmation d'une infobox avec des briques

Predefinição:Article détaillé

Pour les modèles d'infobox ne demandant pas de fonctions complexes particulières, il est 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.

### Programmation d'une infobox modulaire

Predefinição:Article détaillé

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.

## Charte graphique des Infobox V2

### Esthétique générale

Les infobox V2 se veulent modernes sans toutefois sombrer dans les dérives de l'esthétique du « Web 2.0 » à savoir ombres, reflets, 3D... Ce sont des tableaux au fond gris clair, aérés, sans autres bordures que le cadre gris général de la boîte.

Predefinição:Rouge

### Usage des couleurs dans les titres et les sous-titres

#### Optimiser le contraste entre le fond et le texte

Predefinição:Article détaillé

Dans un souci d'accessibilité, il est important que la couleur du fond des titres et des sous-titres soit bien contrastée avec la couleur du texte des titres et des sous-titres. Un bon contraste permet, entre autres choses, aux malvoyants de mieux distinguer les caractères. Il est préférable d'utiliser uniquement comme couleurs de texte le blanc ou le noir. Il faut éviter des textes d'autres couleurs telles que le rouge, le bleu, le vert... Il est recommandé de rédiger les couleurs en triplet hexadécimal tel que #FFFFFF, #000000... plutôt que de donner leur nom en anglais comme *yellow*, *black*... Une couleur rédigée en triplet hexadécimal peut facilement être gérée par des modèles automatisés. Voici ci-après deux exemples de bon et de mauvais contraste :

Predefinição:Infobox/Titre
Predefinição:Infobox/Sous-titre
Predefinição:Infobox/Fin
Predefinição:Infobox/Titre
Predefinição:Infobox/Sous-titre
Predefinição:Infobox/Fin

#### Paramètres de changement de couleurs

Predefinição:Article détaillé

Dans la majorité des cas, les infoboxes ont des couleurs fixes, définies, une seule et unique fois depuis la page du modèle, par les modélistes. Avoir des couleurs fixes est vivement recommandé. Cela permet de limiter les risques de conflits d'édition sur les articles entre plusieurs utilisateurs qui voudraient pour les uns une couleur et pour les autres une autre couleur. On limite également les risques de mauvais contraste entre les couleurs du fond et du texte des titres et des sous-titres. Pour autant, pour des raisons spécifiques et surtout historique au site Wikipédia, il est parfois autorisé aux utilisateurs de pouvoir modifier les couleurs des titres et des sous-titres, directement depuis les articles. Pour ce faire, il existe plusieurs méthodes, parmis lesquelles on peut citer les suivantes :

* **Création de paramètres d'ajout de couleurs**, en ajoutant des paramètres de changement de couleur pour le fond et le texte des titres et des sous-titres. Les couleurs sont laissées au libre choix des utilisateurs depuis les articles sans aucunes restrictions (par exemple, Predefinição:M).
* **Création d'une charte et d'un paramètre sélecteur** afin de contrôler la charte graphique des titres et sous-titres (voir Predefinição:M pour un exemple de charte graphique générique.).

Predefinição:Attention

### Pictogrammes

#### Présentation des pictogrammes

Predefinição:Article détaillé

Initiés par Predefinição:U, les pictogrammes permettent à l'internaute de repérer d'un coup d'œil sur quel type d'article l'utilisateur se trouve. Ils améliorent ainsi l'ergonomie générale de l'encyclopédie et délimitent les chartes graphiques à un domaine donné (par exemple, les notes de musiques scellent la charte graphique des articles musicaux).

Il serait tentant de produire des centaines de pictogrammes pour chacun des types d'articles, mais pour des raisons d'ergonomie et de lourdeur des CSS, il est préférable de s'en tenir aux grands thèmes, tels que musique (notes), cinéma (pellicule), sport (anneaux olympiques), communication (antenne émétrice). L'idée est d'indiquer au visiteur le type d'article en un clin d'œil, et non de générer une liste incalculable de pictogrammes. Trop de pictos tuent les pictos !

Les pictogrammes répondent à plusieurs principes :

* Hauteur fixe de 45 pixels ;
* Semi-transparents ;
* Codés en PNG 24 bits pour gérer les différents degrés de transparence ;
* Conçus pour être alignés à droite de l'en-tête des infoboxes.

#### Pictogrammes dans la feuille de styles

Predefinição:Article détaillé

La nomenclature des pictogrammes doit respecter la convention des noms d'images pour les Infobox V2 : *« Fichier:Picto\_infobox\_nom.png »*. Sur Commons, il faut placer les images dans Category:Infobox pictograms. Afin d'utiliser un nouveau pictogramme dans une infobox, il faut lui associer une classe dans la feuille de style globale de Wikipédia en français, MediaWiki:Common.css. Par exemple, l'association de la classe « artiste » à Fichier:Picto infobox artiste.png est faite à l'aide de :

```
.entete.artiste {
 background: url("//upload.wikimedia.org/wikipedia/commons/f/f3/Picto\_infobox\_artiste.png") no-repeat top right;
}

```

Ces définitions ne peuvent être ajoutées que par un administrateur. Vous pouvez demander cela sur Wikipédia:Demande d'intervention sur un message système. Pour obtenir l'URL correcte, créez un lien avec la syntaxe [[:Media:Picto\_infofox\_*nom*.png]] et récupérez sa cible (exemple : Media:Picto infobox artiste.png).

## Documentation

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

Afin de préserver une uniformité dans les pages de documentation des infoboxes, voici quelques lignes conductrices pour rédiger une page explicative.

### Création

Pour créer une documentation, vous devez mettre le script de l'infobox entre <includeonly>ici le script de l'infobox</includeonly>. Puis vous devez ajouter après cela le script qui permettra de faire apparaître un bandeau de documentation.

```
{{Documentation}}

```

Ce qui sur la page donnera la chose suivante :

```
<includeonly>{{Infobox/Début}}
...
{{Infobox/Fin}}</includeonly><noinclude>{{Documentation}}</noinclude>

```

Un lien 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

La page de documentation d'une infobox doit comporter six informations principales que sont :

* **Bandeau documentation**, il permet de relier la page de documentation au modèle d'infobox correspondant.
* **Syntaxe**, que les utilisateurs devront copier-coller sur les articles
* **Paramètres**, il faut ajouter une définition des différents paramètres disponibles au sein de l'infobox afin d'aider les utilisateurs à savoir comment remplir le modèle sur les articles.
* **Exemple**, il faut ensuite ajouter un exemple de la syntaxe présentée précédemment mais cette fois-ci remplie, avec au passage l'apparition à droite de l'infobox telle qu'elle apparaîtrait sur un article. Puis on doit ajouter ensuite le bandeau {{Projet Infobox}}.
* **Catégories**, 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égories 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.

Voici un exemple type de page de documentation :

```
<noinclude>{{Documentation modèle vue directement}}</noinclude>

== Syntaxe ==

Voici la syntaxe à copier-coller sur les articles :

<pre>
{{Infobox Jardin
}}
</pre>

== Paramètres ==
* <code>nom</code> : Il sert à indiquer le nom du jardin...
* <code>pays</code> : Il sert à indiquer dans quel pays se se trouve le jardin...
* <code>taille</code> : Il sert à donner la taille du jardin...

== Exemple ==

{{Infobox Jardin
}}

<pre style=overflow:auto>
{{Infobox Jardin
}}
</pre>

{{Projet Infobox}}

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

```

## Exemples

### Infobox simples

* Predefinição:M
* Predefinição:M
* Predefinição:M
* Predefinição:M
* Predefinição:M
* Predefinição:M
* Predefinição:M
* Predefinição:M

### Infobox génériques

* Predefinição:M
* Predefinição:M

## Voir aussi

* Projet:Infobox/V2 Débutant
* Catégorie:Modèle infobox V2
* Projet:Infobox
* Projet:Modèle/Harmonisation
* Wikipédia:Atelier accessibilité/Taxobox et infobox

Predefinição:Projet Infobox

\*

sr:Википедија:Пројекат Инфокутије