Modification de Modèle:Country showdata/Documentation

{{Sous-page de documentation}}
Ce modèle est utilisé pour documenter automatiquement les modèles de données du '''[[Projet:Modèle/Système Country|système country]]'''.

Ces modèles sont regroupés dans [[:Catégorie:Modèle Country data]] et sont utilisés par de nombreux modèles de drapeaux [[:Catégorie:Modèle drapeau]].

== Utilisation ==
{{Aide détaillée|Projet:Modèle/Système Country}}
Ce modèle est automatiquement appelé par la syntaxe standard suivante d’un modèle country data :
<pre>
{{ {{{1<noinclude>|country showdata</noinclude>}}}
| alias = nomdupays
| flag alias = Flag of nomdupays.svg
| size = {{{size|}}}
| name = {{{name|}}}
| variant = {{{variant|}}}
}}
</pre>

== Fonctionnement ==
{{Aide détaillée|Projet:Modèle/Système Country#Principe_de_fonctionnement}}

Le premier paramètre d’un modèle country data est habituellement le nom d’un méta-modèle préformaté. Par exemple, [[Modèle:Drapeau]] utilise [[Modèle:Drapeau/callback]] pour générer l’icône du drapeau et le lien wiki. Si le premier paramètre est manquant, ce qui est le cas quand un modèle « country data » est affiché directement, le fragment de code du modèle <code><nowiki>{{{1<noinclude>|country showdata</noinclude>}}}</nowiki></code> provoque l'appel au modèle {{m|country showdata}}, qui est ainsi utilisé comme premier paramètre par défaut. Cette technique permet de s’assurer que tous les modèles country data sont auto-documentés s’ils utilisent la syntaxe standardisée.

Pour une explication détaillée du fonctionnement et des différents paramètres possibles, veuillez consulter '''[[Projet:Modèle/Système Country#Principe_de_fonctionnement]]'''

== Variantes de drapeaux ==
{{Aide détaillée|Projet:Modèle/Système Country#Variantes_de_drapeaux_disponibles}}
Les variantes de drapeaux sont rajoutées au modèle country data par l’inclusion d’un ou plusieurs paramètres <code>flag alias-''variante''</code>, où chaque <code>''variante''</code> est un identifiant unique qui est utilisé par ailleurs comme paramètre optionnel des modèles <code>{{m|Pays|''pays''|''variante''}}</code> et <code>{{m|Drapeau|''pays''|''variante''}}</code>.

Il existe aussi des paramètres spéciaux pour différentes composantes militaires d'un pays. Ces paramètres sont également utilisés par les modèles {{m|Marine de guerre}}, {{m|Armée de l'air}} et {{m|Armée de terre}}. 

Mis à part les variantes des composantes militaires spéciales listées ci-dessous, les différentes variantes de drapeaux doivent êtres documentées. Pour cela il faut utiliser les paramètres de documentation <code>var1</code> à <code>var40</code>.

Les variantes militaires spéciales sont : <code>flag alias-naval</code>, <code>flag alias-air force</code>, <code>flag alias-army</code>, <code>flag alias-marines</code>, <code>flag alias-coast guard</code> et <code>flag alias-military</code>.

Voir '''[[Projet:Modèle/Système Country#Variantes_de_drapeaux_disponibles]]''' pour une explication détaillée.

== Paramètres ==
{{Aide détaillée|Projet:Modèle/Système Country#Paramètres}}
De nombreux modèles country data nécessitent des paramètres supplémentaires par rapport aux paramètres standard <code>alias</code> et <code>flag alias</code>. Certains de ces paramètres additionnels doivent êtres documentés manuellement.

Le système country permet aussi de définir des drapeaux additionnels pour un pays (par exemple pour des drapeaux historiques et des drapeaux/pavillons militaires).

== Catégorisation du modèle ==
{{Aide détaillée|Projet:Modèle/Système Country#Paramètres_de_documentation}}

Chaque modèle country data est automatiquement catégorisé par défaut dans deux catégories : [[:Catégorie:Modèle Country data]] et une catégorie de la forme <code>Catégorie:Modèle ''shortname alias''</code>.

Il est possible de modifier cette catégorisation par défaut ou les clés de tri. Pour cela, voir '''[[Projet:Modèle/Système Country#Paramètres_de_documentation]]'''

== Documentation des modèles ==
{{Aide détaillée|Projet:Modèle/Système Country#Paramètres_de_documentation}}
La documentation d'un modèle country data est générée automatiquement à partir des différentes données contenues dans celui-ci.

Il existe différents paramètres pour permettre de documenter les différentes variantes, redirections et indications de modèles connexes que contiennent un modèle country data. Il est également possible d'écrire une documentation additionnelle personnalisée.

== Voir aussi ==
* [[Projet:Drapeaux]]
* [[Projet:Modèle/Système Country]]
* [[Aide:Modèle pays et drapeau]]

{{Projet|Modèle}}
<includeonly>
[[Catégorie:Modèle du système Country]]
[[Catégorie:Modèle de documentation]]
</includeonly>