Modèle:Country showdata/Documentation

Stargate Wiki Sémantique — La référence sémantique sur l'univers Stargate
Aller à la navigation Aller à la recherche

Ceci est la page de documentation du modèle {{Country showdata/Documentation}}.
Cette page n’est pas destinée à être visualisée directement. Les liens utilisant des pseudo-variables peuvent paraître rompus (en rouge) ; ne pas les remplacer par des noms de pages codés en dur ni des URL.

Ce modèle est utilisé pour documenter le méta-modèle {{country showdata}} utilisé par de nombreux modèles de drapeau Catégorie:modèle drapeau. Des exemples d'utilisation de ce modèle peuvent se trouver dans Catégorie:Modèle Country data

Ce modèle est issu d'un projet sur en:wikipédia (en:Wikipedia:WikiProject Flag Template)

Utilisation[modifier le wikicode]

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

Le premier paramètre d'un modèle country data est habituellement le nom d'un meta-modèle préformaté. Par exemple,modèle:drapeau utilise modèle:Country flag2 pour générer l'icone 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 fragement 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é si ils utilisent la syntaxe standardisé.

Paramètres additionnels[modifier le wikicode]

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ésent), mais aussi documenté 1 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 wikicode]

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

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). Si il existe plus de 9 variantes (par exemple Modèle:Country_data_États-Unis), ceci peuvent être décrit dans une sous page séparée de documentation (voir plus bas).

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

Alias de redirection[modifier le wikicode]

De nombreux modèle "Country data" ont des noms d'alias qui peuvent être utilisé à 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 tels que celles définies dans les normes ISO 3166-1 alpha-3 ou encore par l'IOC mais aussi les codes FIFA. Ceux-ci sont implémentés en tant que redirection 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|Germany}} 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 connexes[modifier le wikicode]

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 de 2 autres modèles connexes, contient le code suivant :

<noinclude>
...
| related1 = Russian Empire
| related2 = RSFS de Russie
| related3 = URSS
| related4 = Commonwealth of Independent States
...
</noinclude>

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

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épublique 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 wikicode]

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