Predefinição:Country showdata/doc

Esta predefinição é utilizada para documentar dados de meta-predefinições de países utilizados pelo Sistema de predefinição de bandeiras. O resultado desta predefinição pode ser visto diretamente visualizando qualquer uma das predefinições em en:Category:Country data templates traduzido para Categoria:!Predefinições Country data.

Ver a principal en:Wikipedia:WikiProject Flag Template traduzido para Wikihelp:WikiProjeto de predefinições de bandeiras para ver a documentação e página de discussão do Sistema de predefinição de bandeiras.

Uso

Esta predefinição é invocada automaticamente pela sintaxe padrão de uma predefinição de dados do país (country data):

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

O primeiro parâmetro para uma predefinição de dados do país é geralmente o nome de uma formatting meta-template. Por exemplo, Predefinição:Flag usa Predefinição:Flag/core para realmente tornar o ícone da bandeira e wikilink. Se o primeiro parâmetro estiver faltando, o que acontece quando uma predefinição de dados do país é visto diretamente, o fragmento de código da predefinição {{{1<noinclude>|country showdata</noinclude>}}} assegura que esta predefinição usará como padrão o primeiro parâmetro. Esta técnica garante que as predefinições de dados do país são "autodocumentados" se usam a sintaxe padrão.

Uso com especificação de link

Esta predefinição pode também ser usada em predefinições "Country data" cujo título do artigo relacionado à predefinição, difere do nome específico da predefinição "Country data". Esta possibilidade permite desambiguar links ou adicionar um link específico.

A especificação do link demanda três alterações em relação ao uso simplificado da predefinição:

• Alterar o parâmetro "alias" para o título do artigo relacionado ou um redirect deste.
• Adicionar o parâmetro "shortname alias", especificando a forma como o link aparecerá.
• Adicionar o parâmetro "templatename", tomando o cuidado de adicionar também <noinclude> </noinclude>. Este parâmetro cria os links contidos na seção "Exemplos de uso". Caso esteja ausente será usado o termo contido no parâmetro "alias =".

Este campo pode ficar ausente quando o termo específico da predefinição é igual ao do artigo relacionado, bastando apenas especificar o campo "shortname alias". Ex.: Predefinição:Country data Distrito Federal (Brasil)

Quando o termo específico da predefinição está ausente ou difere do artigo relacionado, deverá ser especificado. Ex.: Predefinição:Country data Espírito Santo, cujo artigo relacionado é Espírito Santo (estado).

{{ {{{1<noinclude>|country showdata</noinclude>}}}
| alias = <!-- título do artigo relacionado  [ex.: Espírito Santo (estado)]-->
| shortname alias = <!-- forma como o link aparece  [ex.: Espírito Santo]-->
| flag alias = Flag of Countryname.svg
| size = {{{size|}}}
| name = {{{name|}}}
<noinclude>
| templatename = <!-- denominação específica da predefinição [ex.: Distrito Federal (Brasil)]-->
</noinclude>
}}

Predefinições relacionadas

Várias predefinições country data são utilizadas para formas alternativas a predefinição country data comum para a nação, normalmente, mas não exclusivamente, para as nações históricas. Indicadores para estas predefinições suplentes são acréscimos úteis para a documentação da predefinição, para que os editores possam usar a predefinição correta para seus propósitos específicos.

Por exemplo, Predefinição:Country data Sérvia e Montenegro inclui o seguinte código ao documento de três outras predefinições country data relacionadas:

<noinclude>
...
| related1 = Sérvia
| related2 = Montenegro
| related3 = FR Yugoslavia
...
</noinclude>

Documentação adicional

Para situações onde o método de documentação automática não é completamente adequado, a documentação adicional pode ser exibida por country showdata. Basta criar uma subpágina de documentação (nomeada como Predefinição:Country data Countryname/doc) com o material adicional, e será transcluido após todas as outras seções de saída.

Por exemplo:

• Predefinição:Country data Irlanda é usado para explicar por que essa Predefinição é distinta de Predefinição:Country data República da Irlanda
• Predefinição:Country data França é utilizado para documentar a lista de "Predefinição:Country data" disponíveis para cada uma das regiões da França
• Predefinição:Country data Estados Unidos é utilizado para documentar o conjunto de variantes de bandeira (para cada número de estrelas), e a lista de todas as "Predefinição:Country data" disponíveis para o estado e bandeiras de territórios