3 167
edições
Mudanças
Ir para navegação
Ir para pesquisar
Criação da Documentação da Predefinição Country showdata.
{{Subpágina de documentação}}
Esta predefinição é utilizada para documentar dados de meta-predefinições de países utilizados pelo [[:Categoria:Sistema de predefinição de bandeiras|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):
<pre>
{{ {{{1<noinclude>|country showdata</noinclude>}}}
| alias = Countryname
| flag alias = Flag of Countryname.svg
| size = {{{size|}}}
| name = {{{name|}}}
}}
</pre>
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 <code><nowiki>{{{1<noinclude>|country showdata</noinclude>}}}</nowiki></code> 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 <nowiki><noinclude> </noinclude></nowiki>. 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)]].
<pre>
{{ {{{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>
}}
</pre>
<!--
==Additional parameters==
Many country data templates require additional documentation beyond the standard mandatory <code>alias</code> and <code>flag alias</code> parameters. This template will automatically document standard optional parameters (such as <code>shortname alias</code>) if present, and can document unique optional parameters (such as flag variants) if instructed to. This latter method uses documentation-specific parameters in the country data template to activate the additional output from this template. These documentation parameters are set off from the rest of the parameters in the country data template by a <code><nowiki><noinclude></nowiki></code> section:
<pre>
<noinclude>
| var1 = ...
| redir1 = ...
| related1 = ...
</noinclude>
</pre>
===Flag variants===
Flag variants are added to a country data template by the inclusion of one or more <code>flag alias-''label''</code> parameters, where each <code>''label''</code> is a unique identifier that is subsequently used as an input parameter to <code><nowiki>{{flag|...}}</nowiki></code>, <code><nowiki>{{flagicon|...}}</nowiki></code>, etc. To document these flag variants, use the <code>var''N''</code> documentation parameters to identify each label.
Por exemplo, [[Template:Country data Seychelles]] identifies three flag variants (in addition to the current flag) with the following code:
<pre>
| 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
</pre>
These three variants are documented by the following code segment later in the template:
<pre>
<noinclude>
| var1 = 1976
| var2 = 1977
| var3 = colonial
...
</noinclude>
</pre>
Up to nine flag variants can be documented by this method (using <code>var1</code> to <code>var9</code>). If more are present (and currently, only [[Predefinição:Country data Estados Unidos]] has more than nine flag variants), these can be listed on a separate documentation subpage as described below.
Note that you do ''not'' have to use a <code>var''N''</code> parameter for the standard optional variant label <code>naval</code> (used for the country's naval ensign). If present, it will automatically be documented.
===Redirect aliases===
Many country data templates have ''alias'' names that can be used instead of the usual country name with all of the main flag templates. These are usually, but not exclusively, standard country code abbreviations such as those specifed in [[ISO 3166-1 alpha-3]] or by the [[List of IOC country codes|IOC]] or [[List of FIFA country codes|FIFA]]. These are implemented as redirects, and are listed in [[:Category:Country data redirects]].
Por exemplo, [[Template:Country data DEU]] and [[Predefinição:Country data GER]] both redirect to [[Predefinição:Country data Alemanha]], because ''DEU'' is the ISO code and ''GER'' is the IOC and FIFA code for Germany. Therefore, <code><nowiki>{{flagicon|DEU}}</nowiki></code>, <code><nowiki>{{flagicon|GER}}</nowiki></code>, e <code><nowiki>{{flagicon|Alemanha}}</nowiki></code> todos têm o mesmo resultado. Estes redirecionamentos aliases são documentados pelo seguinte código fragmento de predefinição:
<pre>
<noinclude>
...
| redir1 = DEU
| redir2 = GER
...
</noinclude>
</pre>
-->
===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:
<pre>
<noinclude>
...
| related1 = Sérvia
| related2 = Montenegro
| related3 = FR Yugoslavia
...
</noinclude>
</pre>
===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 <code>country showdata</code>. Basta criar uma subpágina de documentação (nomeada como <code>Predefinição:Country data Countryname/doc</code>) 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
<includeonly>
[[Categoria:!Predefinições de recuperação de dados]]
[[Categoria:Sistema de predefinição de bandeiras|{{PAGENAME}}]]
[[Categoria:!Predefinições sobre países]]
</includeonly>
Esta predefinição é utilizada para documentar dados de meta-predefinições de países utilizados pelo [[:Categoria:Sistema de predefinição de bandeiras|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):
<pre>
{{ {{{1<noinclude>|country showdata</noinclude>}}}
| alias = Countryname
| flag alias = Flag of Countryname.svg
| size = {{{size|}}}
| name = {{{name|}}}
}}
</pre>
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 <code><nowiki>{{{1<noinclude>|country showdata</noinclude>}}}</nowiki></code> 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 <nowiki><noinclude> </noinclude></nowiki>. 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)]].
<pre>
{{ {{{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>
}}
</pre>
<!--
==Additional parameters==
Many country data templates require additional documentation beyond the standard mandatory <code>alias</code> and <code>flag alias</code> parameters. This template will automatically document standard optional parameters (such as <code>shortname alias</code>) if present, and can document unique optional parameters (such as flag variants) if instructed to. This latter method uses documentation-specific parameters in the country data template to activate the additional output from this template. These documentation parameters are set off from the rest of the parameters in the country data template by a <code><nowiki><noinclude></nowiki></code> section:
<pre>
<noinclude>
| var1 = ...
| redir1 = ...
| related1 = ...
</noinclude>
</pre>
===Flag variants===
Flag variants are added to a country data template by the inclusion of one or more <code>flag alias-''label''</code> parameters, where each <code>''label''</code> is a unique identifier that is subsequently used as an input parameter to <code><nowiki>{{flag|...}}</nowiki></code>, <code><nowiki>{{flagicon|...}}</nowiki></code>, etc. To document these flag variants, use the <code>var''N''</code> documentation parameters to identify each label.
Por exemplo, [[Template:Country data Seychelles]] identifies three flag variants (in addition to the current flag) with the following code:
<pre>
| 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
</pre>
These three variants are documented by the following code segment later in the template:
<pre>
<noinclude>
| var1 = 1976
| var2 = 1977
| var3 = colonial
...
</noinclude>
</pre>
Up to nine flag variants can be documented by this method (using <code>var1</code> to <code>var9</code>). If more are present (and currently, only [[Predefinição:Country data Estados Unidos]] has more than nine flag variants), these can be listed on a separate documentation subpage as described below.
Note that you do ''not'' have to use a <code>var''N''</code> parameter for the standard optional variant label <code>naval</code> (used for the country's naval ensign). If present, it will automatically be documented.
===Redirect aliases===
Many country data templates have ''alias'' names that can be used instead of the usual country name with all of the main flag templates. These are usually, but not exclusively, standard country code abbreviations such as those specifed in [[ISO 3166-1 alpha-3]] or by the [[List of IOC country codes|IOC]] or [[List of FIFA country codes|FIFA]]. These are implemented as redirects, and are listed in [[:Category:Country data redirects]].
Por exemplo, [[Template:Country data DEU]] and [[Predefinição:Country data GER]] both redirect to [[Predefinição:Country data Alemanha]], because ''DEU'' is the ISO code and ''GER'' is the IOC and FIFA code for Germany. Therefore, <code><nowiki>{{flagicon|DEU}}</nowiki></code>, <code><nowiki>{{flagicon|GER}}</nowiki></code>, e <code><nowiki>{{flagicon|Alemanha}}</nowiki></code> todos têm o mesmo resultado. Estes redirecionamentos aliases são documentados pelo seguinte código fragmento de predefinição:
<pre>
<noinclude>
...
| redir1 = DEU
| redir2 = GER
...
</noinclude>
</pre>
-->
===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:
<pre>
<noinclude>
...
| related1 = Sérvia
| related2 = Montenegro
| related3 = FR Yugoslavia
...
</noinclude>
</pre>
===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 <code>country showdata</code>. Basta criar uma subpágina de documentação (nomeada como <code>Predefinição:Country data Countryname/doc</code>) 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
<includeonly>
[[Categoria:!Predefinições de recuperação de dados]]
[[Categoria:Sistema de predefinição de bandeiras|{{PAGENAME}}]]
[[Categoria:!Predefinições sobre países]]
</includeonly>
