வார்ப்புரு:Country showdata/doc
{{documentation subpage}}
 This template is used for documenting country data meta-templates used by the [[:Category:Flag template system|flag template system]].  The output of this template can be seen by directly viewing any of the templates in [[பகுப்பு:நாட்டுத் தகவல் வார்ப்புருக்கள்]].
 
 See [[Wikipedia:WikiProject Flag Template]] for the main documentation and discussion page for the flag template system.
 
 ==Usage==
 This template is automatically invoked by the standard syntax of a country data template: 
 &lt;pre&gt;
 {{ {{{1&amp;lt;noinclude&amp;gt;|country showdata&amp;lt;/noinclude&amp;gt;}}}
 | alias = Countryname
 | flag alias = Flag of Countryname.svg
 | size = {{{size|}}}
 | name = {{{name|}}}
 }}
 &lt;/pre&gt;
 The first parameter to a country data template is usually the name of a ''formatting meta-template''.  For example, [[வார்ப்புரு:கொடி]] uses [[Template:Country flag2]] to actually render the flag icon and wikilink.  If the first parameter is missing, which is the case when a country data template is viewed directly, the template code fragment &lt;code&gt;&lt;nowiki&gt;{{{1&amp;lt;noinclude&amp;gt;|country showdata&amp;lt;/noinclude&amp;gt;}}}&lt;/nowiki&gt;&lt;/code&gt; ensures that ''this'' template will be used as the default first parameter.  This technique ensures that country data templates are &quot;self-documenting&quot; if they use the standard syntax.
 
 ==Additional parameters==
 Many country data templates require additional documentation beyond the standard mandatory &lt;tt&gt;alias&lt;/tt&gt; and &lt;tt&gt;flag alias&lt;/tt&gt; parameters.  This template will automatically document standard optional parameters (such as &lt;tt&gt;shortname alias&lt;/tt&gt; and/or &lt;tt&gt;alt attribute&lt;/tt&gt;) 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 &lt;tt&gt;&lt;nowiki&gt;&amp;lt;noinclude&amp;gt;&lt;/nowiki&gt;&lt;/tt&gt; section:
 &lt;pre&gt;
 &amp;lt;noinclude&amp;gt;
 | var1 = ...
 | redir1 = ...
 | related1 = ...
 &amp;lt;/noinclude&amp;gt;
 &lt;/pre&gt;
 
 ===Flag variants===
 Flag variants are added to a country data template by the inclusion of one or more &lt;tt&gt;flag alias-''label''&lt;/tt&gt; parameters, where each &lt;tt&gt;''label''&lt;/tt&gt; is a unique identifier that is subsequently used as an input parameter to &lt;tt&gt;&lt;nowiki&gt;{{flag|...}}&lt;/nowiki&gt;&lt;/tt&gt;, &lt;tt&gt;&lt;nowiki&gt;{{flagicon|...}}&lt;/nowiki&gt;&lt;/tt&gt;, etc.  To document these flag variants, use the &lt;tt&gt;var''N''&lt;/tt&gt; documentation parameters to identify each label.
 
 For example, [[Template:Country data Seychelles]] identifies three flag variants (in addition to the current flag) with the following code:
 &lt;pre&gt;
 | 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
 &lt;/pre&gt;
 These three variants are documented by the following code segment later in the template:
 &lt;pre&gt;
 &amp;lt;noinclude&amp;gt;
 | var1 = 1976
 | var2 = 1977
 | var3 = colonial
 ...
 &amp;lt;/noinclude&amp;gt;
 &lt;/pre&gt; 
 Up to nine flag variants can be documented by this method (using &lt;tt&gt;var1&lt;/tt&gt; to &lt;tt&gt;var9&lt;/tt&gt;).  If more are present (and currently, only [[வார்ப்புரு:நாட்டுத் தகவல் ஐக்கிய அமெரிக்க நாடுகள்]] 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 &lt;tt&gt;var''N''&lt;/tt&gt; parameter for the standard optional variant label &lt;tt&gt;naval&lt;/tt&gt; (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 [[பன்னாட்டு ஒலிம்பிக் குழுவின் நாடுகளின் பட்டியல்|IOC]] or [[பீஃபா நாட்டுக் குறியீடுகளின் பட்டியல்|FIFA]].  These are implemented as redirects, and are listed in [[பகுப்பு:நாட்டுத் தகவல் வார்ப்புரு வழிமாற்றிகள்]].
 
 For example, [[வார்ப்புரு:நாட்டுத் தகவல் இடாய்ச்சுலாந்து]] and [[வார்ப்புரு:நாட்டுத் தகவல் இடாய்ச்சுலாந்து]] both redirect to [[வார்ப்புரு:நாட்டுத் தகவல் இடாய்ச்சுலாந்து]], because ''DEU'' is the ISO code and ''GER'' is the IOC and FIFA code for Germany.  Therefore, &lt;tt&gt;&lt;nowiki&gt;{{flagicon|DEU}}&lt;/nowiki&gt;&lt;/tt&gt;, &lt;tt&gt;&lt;nowiki&gt;{{flagicon|GER}}&lt;/nowiki&gt;&lt;/tt&gt;, and &lt;tt&gt;&lt;nowiki&gt;{{flagicon|Germany}}&lt;/nowiki&gt;&lt;/tt&gt; all have the same result.  These redirect aliases are documented by the following template code fragment:
 &lt;pre&gt;
 &amp;lt;noinclude&amp;gt;
 ...
 | redir1 = DEU
 | redir2 = GER
 ...
 &amp;lt;/noinclude&amp;gt;
 &lt;/pre&gt;
 
 ===Related templates===
 Several country data templates are used for alternate forms to the common country data template for the nation, usually but not exclusively for historic nations.  Pointers to these alternate templates are useful additions to the template documentation so that editors can use the correct template for their specific purposes.
 
 For example, [[வார்ப்புரு:நாட்டுத் தகவல் செர்பியா மொண்டெனேகுரோ]] includes the following code to document three other related country data templates:
 &lt;pre&gt;
 &amp;lt;noinclude&amp;gt;
 ...
 | related1 = Serbia
 | related2 = Montenegro
 | related3 = FR Yugoslavia
 ...
 &amp;lt;/noinclude&amp;gt;
 &lt;/pre&gt;
 
 ===Additional documentation===
 For situations where the automatic documentation method is not completely adequate, additional documentation can be displayed by &lt;tt&gt;country showdata&lt;/tt&gt;.  Simply create a documentation subpage (named as &lt;tt&gt;Template:Country data Countryname/doc&lt;/tt&gt;) with the additional material, and it will be transcluded after all other output sections.
 
 For example:
 *[[Template:Country data Ireland/doc]] is used to explain why that template is distinct from [[வார்ப்புரு:நாட்டுத் தகவல் அயர்லாந்து குடியரசு]]
 *[[Template:Country data France/doc]] is used to document the list of country data templates available for each of the regions of France