Modelo:Country showdata/uso

Obxectivo

Este modelo é usado para documentar meta-modelos de country data usados polo sistema de modelos de bandeira. A saída deste modelo pode verse usando os modelos de países e lugares da Categoría:Modelos Country data.

Uso

Este modelo é invocado automaticamente pola sintaxe estándar do modelo Country data:

{{ {{{1<noinclude>|country showdata</noinclude>}}}
| alias = Nomepaís
| shortname alias = Nomecurtopaís <!-- só necesario se Nomecurtopaís ≠ Nomepaís, noutro caso omitir -->
| flag alias = Bandeira de Nomepaís.svg
| size = {{{tamaño|}}}
| name = {{{nome|}}}
| variant = {{{variante|}}}  <!-- só necesario se hai un ou máis parámetros de variantes de bandeira, noutro caso omitir -->
}}

O primeiro parámetro dun modelo Country data é normalmente o nome dun meta-modelo de formato. Se non se indica o primeiro parámetro, que é o que sucede cando se visualiza un modelo country data directamente, o fragmento de código {{{1<noinclude>|country showdata</noinclude>}}} asegura que este modelo será usado como primeiro parámetro por defecto. Esta técnica asegura que os modelos country data están "auto-documentados" se usan a sintaxe estándar.

Parámetros adicionais

Moitos modelos Country data requiren datos adicionais alén dos obrigatorios alias e flag alias. O modelo documentará automaticamente os parámetros opcionais estándar, como shortname alias, se presente, e pode documentar parámetros opcionais únicos, como variacións de bandeiras, se instruído para tal. Este último xeito usa parámetros específicos de documentación no modelo Country data para accionar saída de datos complementar. Tales parámetros de documentación son definidos baseados nos outros parámetros informados na sección <noinclude>:

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

Variacións de bandeiras

As variacións de bandeiras son definidas nun modelo Country data por un ou mais parámetros flag alias-label, no que cada label é un identificador único que é en seguida usado como dato de entrada para {{flag|...}}, {{flagicon|...}}, etc. Para informar estas variacións de bandeiras, use os parámetros de documentación varN para identificar cada un dos casos.

Por exemplo, o Modelo:Country data Seychelles, alén da actual bandeira, identifica tres variacións de bandeiras por medio do seguinte código:

| flag alias-1976 = Flag of the Seychelles 1976.svg
| flag alias-1977 = Flag of the Seychelles 1977.svg
| flag alias-colonial = Government Ensign of the United Kingdom.svg

Esas tres variacións son identificadas conforme o treito de código seguinte:

<noinclude>
| var1 = 1976
| var2 = 1977
| var3 = colonial
...
</noinclude>

Ata corenta variacións de bandeiras poden ser definidas segundo esta maneira, usando var1 a var40. Se un número maior existir, o exceso pode ser listado en subpáxina de documentación apartada, conforme descrito abaixo.

Importante notar que non se debe usar parámetros do tipo varN para as variacións estándar naval, forza aérea e exército, que son usados para os signos da mariña, forza aérea e exército, respectivamente. Se presentes, serán automaticamente documentados.

Alias de redirección

Moitos modelos Country data teñen nomes de alias que poden ser usados no lugar do nome ordinario do país con tódalos modelos principais de bandeiras. Estes son xeralmente, pero sen ser de modo exclusivo, os códigos das abreviacións estándar conforme a especificación ISO, IOC ou da FIFA. Son, así, formados como redireccións, sendo listados en Categoría:Redireccións de modelos Country data.

Por example, Modelo:Country data DEU e Modelo:Country data GER levan ambos para Modelo:Country data Alemaña, porque DEU é o código ISO e GER significa tanto o código IOC coma o da FIFA para o país. Deste modo, {{flagicon|DEU}}, {{flagicon|GER}} e {{flagicon|Alemaña}} dan sempre o mesmo resultado. Estes alias de redirección son amosados no seguinte treito de código:

<noinclude>
...
| redir1 = DEU
| redir2 = GER
...
</noinclude>

Ata cinco redireccións de bandeiras poden ser implementados deste xeito, usando de redir1 a redir5.

Modelos correlativos

Un bo número de modelos Country data son usados como alternativa ó modelo Country data común, xeralmente para as nacións históricas ou estados extintos, mais non só neses casos. Ligazóns para tales modelos alternativos son información prácticas, de modo que os editores poidan usar o modelo máis apropiado ós diversos propósitos.

Por exemplo, Modelo:Country data Serbia e Montenegro ten o código seguinte, que amosa outras tres ligazóns para modelos relacionados:

<noinclude>;
...
| related1 = Serbia
| related2 = Montenegro
| related3 = RF Iugoslavia
...
</noinclude>;

Ata seis ligazóns poden ser implementadas deste xeito, usando de related1 a related6.

Ligazón do artigo da badeira

A caixa de instrucións do modelo amosa unha imaxe no lado dereito, cunha ligazón cara ó artigo sobre a bandeira caso haxa un. A páxina de retorno é "Bandeira de {{{alias}}}", con base no valor de |alias=, do código fonte do modelo, no lugar de {{{alias}}}. Se houber un artigo sobre a bandeira, mesmo que "Bandeira de {{{alias}}}" non exista, débese entón crear unha páxina de contido correcto ou direccionar cara á páxina por medio do seguinte parámetro:

<noinclude>
...
| flag link = ''Nome do artigo sobre a bandeira''
...
</noinclude>

Pódese tamén usalo para sobrescribir a ligazón automática, se un artigo "Bandeira de {{{alias}}}" existe de feito, mais é o artigo errado.