Modèle:Country showdata

Une page de Wikipédia, l'encyclopédie libre.
Sauter à la navigation Sauter à la recherche

 Documentation[modifier] [purger]

Ce modèle est utilisé pour documenter les modèles de données du 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[modifier le code]

Ce modèle est automatiquement appelé par la syntaxe standard d’un modèle country data :

{{ {{{1<noinclude>|country showdata</noinclude>}}}
| alias = nomdupays
| flag alias = Flag of nomdupays.svg
| size = {{{size|}}}
| name = {{{name|}}}
| variant = {{{variant|}}}
}}

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 {{{1<noinclude>|country showdata</noinclude>}}} s’assure que ce modèle ({{country showdata}}) sera utilisé comme premier paramètre par défaut. Cette technique permet de s’assurer que les modèles de country data sont auto-documentés s’ils utilisent la syntaxe standardisée.

Paramètres additionnels[modifier le code]

De nombreux modèles « country data » nécessitent des paramètres supplémentaires par rapport aux paramètres standard alias et flag alias. Ce modèle documentera automatiquement les paramètres standards optionnels (tels que shortname alias et alt attribute) s’ils sont présents), mais aussi un unique paramètre optionnel (tel que les variantes d’un drapeau) si cela est demandé. Cette dernière méthode utilise des paramètres spécifiques de documentation dans le modèle « country data » afin d’activer la génération de ces éléments additionnels à l’aide de ce modèle. Ces paramètres de documentation sont définis à part dans le modèle « country data » dans la section <noinclude>:

<noinclude>
| var1 = ...
| redir1 = ...
| related1 = ...
</noinclude>

Variantes du drapeau[modifier le code]

Les variantes de drapeaux sont rajoutées au modèle country data par l’inclusion d’un ou plusieurs paramètres flag alias-tag, où chaque tag est un identifiant unique qui est utilisé par ailleurs comme paramètre optionnel du modèle {{drapeau|...}}, {{flagicon|...}}, etc. Pour documenter ces variantes, utilisez les paramètres de documentation varN pour identifier chaque balise.

Par exemple, modèle:Country data Afrique du Sud propose 4 variations (en sus du drapeau courant) avec ce fragment de code :

| flag alias-1910 = South Africa Red Ensign.png
| flag alias-1928 = Flag of South Africa 1928-1994.svg
| flag alias-naval = Naval Ensign of South Africa.svg
| flag alias-air force = Ensign of the South African Air Force.svg

Deux de ces variations sont documentées par le fragment de code suivant :

<noinclude>
| var1 = 1910
| var2 = 1928
...
</noinclude>

Jusqu’à 9 variantes peuvent être documentées à l’aide de cette méthode (de var1 à var9). S’il existe plus de 9 variantes (par exemple Modèle:Country_data_États-Unis), celles-ci peuvent être décrites dans une sous-page séparée de documentation (voir plus bas).

Remarquez que l’on n’a pas besoin d’utiliser un paramètre varN pour la balise de la variante standard optionnelle naval (qui est utilisée pour le pavillon de la marine nationale du pays). S’il est présent il sera automatiquement documenté.

Alias de redirection[modifier le code]

De nombreux modèles « Country data » ont des noms d’alias qui peuvent être utilisés à la place du nom usuel du pays avec les principaux modèles de drapeau. Ceux-ci sont habituellement, mais pas seulement, les abréviations standards des codes des pays telles que celles définies dans les normes ISO 3166-1 alpha-3 ou encore par le CIO mais aussi les codes FIFA et certains codes postaux (par ex. états des États-Unis, provinces et territoires du Canada). Ceux-ci sont implémentés en tant que redirections vers le modèle country data du pays.

Par exemple, Modèle:Country data FRA est une redirection vers Modèle:Country data France, parce que FRA est le code ISO pour la France. Donc, {{flagicon|FRA}}, et {{flagicon|France}} affichent le même résultat. Ces alias de redirection sont documentés par le fragment de code suivant :

<noinclude>
...
| redir1 = FRA
...
</noinclude>

Modèles apparentés[modifier le code]

Plusieurs modèles Country data sont utilisés comme une solution alternative au modèle Country data commun pour un pays, habituellement pour des raisons historiques. Des liens vers ces modèles alternatifs sont des ajouts utiles à la documentation du modèle afin que les contributeurs puissent utiliser le modèle le plus approprié dans leurs cas.

Par exemple, modèle:Country data Russie, afin d’indiquer la présence d’autres modèles connexes, contient le code suivant :

<noinclude>
...
| related1 = Empire russe
| related2 = RSFS de Russie
| related3 = URSS
| related4 = Communauté des États indépendants
...
</noinclude>

Catégorie du modèle[modifier le code]

Le modèle comporte par défaut deux catégories : Catégorie:Modèle Country data et une catégorie de la forme Catégorie:Modèle {{{shortname alias}}}. S’il n’y a pas besoin de créer une catégorie spécifique au pays (par exemple une des républiques de l’URSS), il est possible d’ajouter le paramètre {{{cat}}} pour spécifier le nom du pays dans lequel inclure le modèle.

Exemple :

<noinclude>
...
| cat = URSS
...
</noinclude>

Documentation additionnelle[modifier le code]

Pour des cas où la documentation auto-générée serait insuffisante, une documentation additionnelle peut être affichée par country showdata. En créant une sous-page de documentation (nommée selon modèle:Country data Countryname/Documentation) contenant les informations supplémentaires, il sera automatiquement « transclus » à la suite des sections auto-générées.

Pour ajouter un texte court dans la documentation sans créer de sous-page dédiée, il est possible d'utiliser le paramètre contenu : {{Country showdata|contenu=Texte additionnel}}