మూస:Flagg/doc పేజీ సోర్సు చూడండి

{{documentation subpage}}
{{Lua|Module:Flagg|Module:Flagg/Altvar data|Module:CountryData}}
{{#ifeq:{{NAMESPACE}}|Module|{{Module rating|beta}}}}
{{tnull|Flagg}} (<u>flag</u> <u>g</u>eneral) is a [[WP:WPFT|flag template]] with variable output format. Using [[WP:Lua|Lua]] instead of the [[WP:WPFT#How it works|standard mechanism]], it allows overriding the image name and link target, and works even if a [[:Category:Country data templates|country data template]] for an entity does not exist (without using any [[WP:Template limits#Expensive parser function calls|expensive functions]]).

The template is not intended to fully supersede any specific flag templates it can simulate (see [[#Comparison with other templates|below]]), but can be useful for formats for which no template exists, or if its additional options are needed.

== Parameters ==
Aliases (alternatives) for each parameter or value are given in square brackets.

=== Format (first unnamed parameter) ===
The first parameter is an alphabetic code specifying the output format. The first letter concerns the image, the second the separator, and the third the country name. The parameter is fully case-insensitive.

If any position in the parameter value is missing or has a character not corresponding to an option below, the options marked as default will be used; e.g. a first parameter equal to {{mono|i}}, {{mono|i**}} or {{mono|izz}} will be read as {{mono|isc}}.

'''Image''' (first letter)
{|class="wikitable"
! Letter !! Meaning !! Description !! Example
|-
| {{mono|u}} || <u>u</u>nlinked || Image is not linked (default). || {{#invoke:DemoTemplate|flagg|uxx|France}}
|-
| {{mono|c}} || <u>c</u>ountry || Image links to country/entity page. || {{#invoke:DemoTemplate|flagg|cxx|France}}
|-
| {{mono|p}} [{{mono|f}}] || <u>p</u>refix/suffix || Image links to country name with prefixed and/or suffixed text (default "Flag of ..."), set using {{para|pref}} and {{para|suff}} (see [[#pref|below]]). || {{#invoke:DemoTemplate|flagg|pxx|France}}
|- id="i"
| {{mono|i}} || <u>i</u>mage page || Image links to file description page; use this for non-public-domain images, for which attribution is required. || {{#invoke:DemoTemplate|flagg|ixx|France}}
|-
| {{mono|d}} || <u>d</u>ata template || Image links to the used country data template, for use in discussion/documentation. Automatically adds <code>redirect=no</code> if link is a redirect. || {{#invoke:DemoTemplate|flagg|dxx|France}}
|- id="x"
| {{mono|x}} || [[X mark]] || No image is displayed. If the second letter is anything other than {{mono|x}}, and [[#o|{{mono|o}}]] is not set, an unlinked transparent image is actually used to preserve the spacing. || {{#invoke:DemoTemplate|flagg|xnx|France}}
|}

'''Separator''' (second letter)
{|class="wikitable"
! Letter !! Meaning !! Description !! colspan="2"|Example
|- id="s"
| {{mono|s}} || <u>s</u>pan box || The flag image is put in a fixed-width &lt;span&gt; tag, meaning the country names are aligned in vertical lists; see documentation of {{tl|Flaglist}} (default). || colspan="2"|{{#invoke:DemoTemplate|flagg|usu|Niger}}
|- id="n"
| {{mono|n}} || <u>n</u>on-breaking space || A non-breaking space (<code>&amp;nbsp;</code>) is used, like in most flag templates, including {{tl|flag}}. Note that &amp;nbsp; does not actually prevent wrapping between image and text in all browsers; use [[#w|{{mono|w}}]] as described below if needed. || colspan="2"|{{#invoke:DemoTemplate|flagg|unu|Niger}}
|- id="l"
| {{mono|l}} || <u>l</u>ine break || A line break (<code>&lt;br/&gt;</code>) is used as separator. || colspan="2"|{{#invoke:DemoTemplate|flagg|ulu|Niger}}
|- id="t"
| {{mono|t}} || <u>t</u>able cell || A table cell separator (two pipes) is used. || {{#invoke:DemoTemplate|flagg|utu|Niger}}
|-
| {{mono|x}} || X mark || No separator is used. || colspan="2"|{{#invoke:DemoTemplate|flagg|uxu|Niger}}
|}

'''Name''' (third letter)
{|class="wikitable"
! Letter !! Meaning !! Description !! Example
|-
| {{mono|c}} || <u>c</u>ountry || The country name links to the main country/entity page (default). || {{#invoke:DemoTemplate|flagg|xxc|Chile}}
|-
| {{mono|p}} || <u>p</u>refix/suffix || The country name links to the country page with prefixed or suffixed text (default "Flag of ..."), set using {{para|pref}} and {{para|suff}} (see [[#pref|below]]). || {{#invoke:DemoTemplate|flagg|xxp|Chile}}
|- id="f"
| {{mono|f}} || <u>f</u>ull prefix/suffix || Same as {{mono|p}}, except that the prefix and/or suffix is/are displayed. || {{#invoke:DemoTemplate|flagg|xxf|Chile}}
|- id="b"
| {{mono|b}} || <u>b</u>oth country and prefix/suffix || Combined country link and prefix/suffix link: country name links to country page, while prefix and/or suffix link(s) to prefixed/suffixed title. || {{#invoke:DemoTemplate|flagg|xxb|Chile}}
|-
| {{mono|u}} || <u>u</u>nlinked (cf. {{tl|flagu}}) || The country name is displayed as plain text, without link. || {{#invoke:DemoTemplate|flagg|xxu|Chile}}
|-
| {{mono|d}} || <u>d</u>ata template || Country name is linked to the used country data template, for use in discussion/documentation. Automatically adds <code>redirect=no</code> if a redirect is used. || {{#invoke:DemoTemplate|flagg|xxd|Chile}}
|-
| {{mono|x}} || X mark || No text is displayed. || {{#invoke:DemoTemplate|flagg|xxx|Chile}}
|}

Some additional options can be enabled by appending the following letters to the three-letter code in any order:
{| class="wikitable"
! Letter !! Description !! Example
|- id="a"
| {{mono|a}} || Adds the country name (the "name" parameter, or if unset the second unnamed parameter) as <u>a</u>lt text and mouseover for the image. If [[#alt|{{para|alt}}]] is used for a custom alt/mouseover text, this does not need to be separately set. || {{#invoke:DemoTemplate|flagg|uxxa|Pakistan}}
|- id="e"
| {{mono|e}} || Uses the name set in the country data template (rather than the first parameter) as display name, like in {{tl|flagcountry}} (i.e. <u>e</u>xpands abbreviated forms). || {{#invoke:DemoTemplate|flagg|unue|PAK}}
|- id="o"
| {{mono|o}} || <u>O</u>mits the image and spacing in case the image is an invisible placeholder, i.e., only include the spacing if a flag is displayed. Useful for inline/standalone usages or horizontal lists, where name alignment is not needed. || {{#invoke:DemoTemplate|flagg|unuo|Pakistan|image=}}<br/>Compare with:<br/>{{#invoke:DemoTemplate|flagg|unu|Pakistan|image=}}
|- id="r"
| {{mono|r}} || Reverses the order of the elements, putting the image to the <u>r</u>ight of the name; cf. {{tl|flagright}}. Doesn't affect the order of letters in the format code. || {{#invoke:DemoTemplate|flagg|uncr|Pakistan}}
|- id="w"
| {{mono|w}} || Avoids <u>w</u>rapping by adding {{tag|span|params=class="nowrap"}} around the output. || {{#invoke:DemoTemplate|flagg|unuw|Pakistan}}
|}

=== Entity (second unnamed parameter) ===
The second parameter is the country or entity name. The template attempts to read the flag and link data from "Template:Country data ''country''"; if that does not exist, the same parameter will be used as default country link and no automatic image will be displayed. The parameter also defines the default displayed country name, if the [[#e|{{mono|e}}]] option above is not used.

=== Image parameters ===
;{{para|variant}} [third unnamed parameter]
:Specifies a variant flag image, as defined and documented in each entity's data template. For example, {{#invoke:DemoTemplate|flagg|ixx|Germany|naval}} uses the "naval" variant of [[Template:Country data Germany]].
;{{para|image}}
:Custom image name, with or without the "File:" namespace prefix. Can be used if the wanted image is not available as variant for the entity (you can alternatively request it be added at the respective data template's talk page), or if no data template exists. Set to "none" ["blank", empty string] to use an unlinked transparent image (functionally identical to the [[#x|{{mono|x}}]] format).
;{{para|size}} [{{para|sz}}]
:Sets the image size; default is 23&times;15 pixels (larger for [[:Category:Country data templates with distinct default size|some entities]]). You can use an explicit size in pixels (e.g. 30x20px; the "px" suffix is optional) or one of the relative sizes "xs" (half the default dimensions), "s", "m", "l" and "xl" (twice the default size).
;{{para|border}}
:By default, the flag icon includes a border, except if it is disabled in the entity's country data template. {{para|border}} can be set to "yes" ["y", "1"] to force a border when excluded by default, or "no" ["n", "0", empty string] to prevent one.
;{{anchor|align}}{{para|align}} [{{para|al}}]
:Set to "left" ["l"], "center" ["centre", "c", "middle", "m"] or "right" ["r"] to set the alignment of the image for the span box ([[#s|{{mono|s}}]]) and table cell ([[#t|{{mono|t}}]]) formats. For {{mono|t}}, the default is center; for {{mono|s}}, it is right-aligned if [[#r|{{mono|r}}]] is set, else left-aligned.
;{{para|width}} [{{para|w}}]
:Sets the width of the span box surrounding the image for the span box ([[#s|{{mono|s}}]]) format, in pixels, without the "px" suffix. The default is calculated by [[Module:Flaglist]] and depends on the image size.
;{{anchor|alt}}{{para|alt}}
:Sets alt text and mouseover text for the flag image, if it is for information rather than just decoration. If the wanted text is equal to the entity name, use the [[#a|{{mono|a}}]] option described above.
;{{para|ilink}}
:Overrides the link target of the image (only use if none of the image formats above allow linking to the desired page)

=== Text and link parameters ===
;{{para|name}}
:Changes the displayed country name. Note that with the [[#f|{{mono|f}}]] format, this includes the prefix and/or suffix.
;{{para|clink}} [{{para|link}}]
:Overwrites the link to the country article; this is also used to construct the prefix/suffix link for the {{mono|f}}, {{mono|p}} and {{mono|b}} options.
;{{anchor|pref}}{{para|pref}}, {{para|suff}}, {{para|plink}}
:{{para|pref}} and {{para|suff}} set the prefix and suffix to use for the prefix/suffix links (format letters {{mono|f}}, {{mono|p}} and {{mono|b}}). The default, if neither is specified, is "Flag of" as prefix (cf. {{tl|flagof}}) and no suffix. {{para|plink}} can be used to override the combined link.
;{{para|the}}
:Set to "yes" ["y", "1"] to include the article "the" before the country name in the prefix/suffix links. Example: {{#invoke:DemoTemplate|flagg|usf|Philippines|the=1}}. Use {{para|pthe}} if the link needs "the" but the name doesn't, and {{para|nthe}} if the name needs it but the link doesn't.
;{{para|section}}
:Links to a section of the linked article without displaying the section name. If both a country link and a prefix/suffix link are used, use {{para|csection}} for a section of the country article, and {{para|psection}} for a section of the prefixed/suffixed article.
;{{para|altvar}} [{{para|avar}}], {{para|age}}
:Enables using one of a set of standard suffixes for linking to sports teams and militaries. The altvar and suffix data is loaded from [[Module:Flagg/Altvar data]]. The possible parameter values are the base names of the corresponding specialized templates; alias values from full sports names exist (see examples below and data page). For some entities this also changes the image to a variant specific to a sport or military branch; for example, {{#invoke:DemoTemplate|flagg|usp|Ireland|avar=ru}} uses the [[List of flags of Ireland#Sporting flags|IRFU flag]] to represent the Irish rugby union team. For youth teams in some sports (see the data page), the age limit must be additionally set using {{para|age}}.
;{{para|nalign}} [{{para|nal}}]
:Sets the alignment of the text in table cell format ({{mono|t}}). The default is left; the possible values are the same as for [[#align|{{para|align}}]].
;{{para|text}}
:Overrides the entire text; only use when necessary for any nonstandard formats. Alternatively, you can set the third letter of the format parameter to {{mono|x}} (no text) and add custom text outside the template.
;{{para|nodata|y}}
:Overrides attempts to use the corresponding {{tld|country data ...}} template, which is useful when the corresponding data template doesn't exist.

== Examples ==
Formats:
*{{#invoke:DemoTemplate|flagg|usc|Fiji}} (default format)
*{{#invoke:DemoTemplate|flagg||Fiji}} (default format)
*{{#invoke:DemoTemplate|flagg|pnbr|Fiji}}
*<code>&lt;span style="display:inline-block;text-align:center;"&gt;{{((}}flagg|ilf|Fiji|sz=xl{{))}}&lt;/span&gt;</code> &rarr; <span style="display:inline-block;text-align:center;">{{flagg|ilf|Fiji|sz=xl}}</span>

Table format & alignment:
{| class="wikitable" style="width:75%;"
| {{tnull|flagg|utu|Jamaica}} || {{flagg|utu|Jamaica}}
|-
| {{tnull|flagg|utur|Jamaica}} || {{flagg|utur|Jamaica}}
|-
| {{tnull|flagg|utu|Jamaica|al{{=}}l|nal{{=}}l}} || {{flagg|utu|Jamaica|al=l|nal=l}}
|-
| {{tnull|flagg|utu|Jamaica|al{{=}}c|nal{{=}}c}} || {{flagg|utu|Jamaica|al=c|nal=c}}
|-
| {{tnull|flagg|utu|Jamaica|al{{=}}r|nal{{=}}r}} || {{flagg|utu|Jamaica|al=r|nal=r}}
|}
*{{#invoke:DemoTemplate|flagg|usu|Switzerland}}
*{{#invoke:DemoTemplate|flagg|usu|Switzerland|al=l}}
*{{#invoke:DemoTemplate|flagg|usu|Switzerland|al=c}}
*{{#invoke:DemoTemplate|flagg|usu|Switzerland|al=r}}

Standard image & name parameters:
*{{#invoke:DemoTemplate|flagg|isc|Myanmar}}
*{{#invoke:DemoTemplate|flagg|isc|Myanmar|border=}}
*{{#invoke:DemoTemplate|flagg|isc|Myanmar|1974}}
*{{#invoke:DemoTemplate|flagg|isc|Myanmar|variant=1974}}
*{{#invoke:DemoTemplate|flagg|isc|Myanmar|variant=1974|name=Burma}}
*{{#invoke:DemoTemplate|flagg|isc|Burma|variant=1974}}
*{{#invoke:DemoTemplate|flagg|isc|Myanmar|sz=30}}
*{{#invoke:DemoTemplate|flagg|isc|Myanmar|size=30}}
*{{#invoke:DemoTemplate|flagg|isc|Myanmar|size=30px}}
*{{#invoke:DemoTemplate|flagg|isc|Myanmar|size=30x18px}}
*{{#invoke:DemoTemplate|flagg|isc|Myanmar|size=xs}}
*{{#invoke:DemoTemplate|flagg|isc|Myanmar|size=xl}}
*{{#invoke:DemoTemplate|flagg|isc|Myanmar|size=xs|width=30}}
*{{#invoke:DemoTemplate|flagg|isc|Myanmar|image=}}
*<code>{{((}}flagg|isc|Myanmar|image=Flag of None.svg{{))}}</code> &rarr; {{flagg|isc|Myanmar|image=Flag of None.svg|demo=1}}
*<code>{{((}}flagg|isc|Myanmar|image=File:Flag of None.svg{{))}}</code> &rarr; {{flagg|isc|Myanmar|image=File:Flag of None.svg|demo=1}}

Links and altvars:
*{{#invoke:DemoTemplate|flagg|psp|Egypt}}
*{{#invoke:DemoTemplate|flagg|psf|Egypt}}
*{{#invoke:DemoTemplate|flagg|psb|Egypt}}
*{{#invoke:DemoTemplate|flagg|psb|Philippines|the=1}}
*{{#invoke:DemoTemplate|flagg|csc|Egypt|section=History}}
*{{#invoke:DemoTemplate|flagg|csb|Egypt|csection=History}}
*{{#invoke:DemoTemplate|flagg|psb|Egypt|variant=1922|psection=Kingdom of Egypt (1922–1953)}}
*{{#invoke:DemoTemplate|flagg|psb|Egypt|plink=List of Egyptian flags}}
*{{#invoke:DemoTemplate|flagg|psf|Egypt|pref=History of}}
*{{#invoke:DemoTemplate|flagg|psp|Egypt|suff=at the Olympics}}
*{{#invoke:DemoTemplate|flagg|psp|Egypt|avar=fb}}
*{{#invoke:DemoTemplate|flagg|psp|Egypt|avar=football}}
*{{#invoke:DemoTemplate|flagg|psp|Egypt|avar=fbu|age=20}}
*{{#invoke:DemoTemplate|flagg|psf|Egypt|avar=navy}}

Non-existing data template: {{#ifexist:Template:Country data Belfast|''{{red|A data template does exist; this documentation needs updating.}}''}}
*{{#invoke:DemoTemplate|flagg|isc|Belfast}}
*{{#invoke:DemoTemplate|flagg|isc|Belfast|image=Flag of Belfast.svg}}

== Comparison with other templates ==
These "specialized" templates predate Flagg, and while most do not have options for custom links and images, they are probably faster because they only do two transclusions without invoking Lua.

=== General templates ===
{| class="wikitable"
!Template!!Corresponding {{tnull|flagg}} syntax!!Example
|-
|{{tlx|flag|''country''}}||{{tnull|flagg|unc|''country''}}||{{#invoke:DemoTemplate|flag|China}}<br/>{{#invoke:DemoTemplate|flagg|unc|China}}
|-
|{{tlx|flagbig|''country''}}||{{tnull|flagg|ulc|''country''|sz{{=}}l}}||{{#invoke:DemoTemplate|flagbig|China}}<br/>{{#invoke:DemoTemplate|flagg|ulc|China|sz=l}}
|-
|{{tlx|flagc|''country''}}||{{tnull|flagg|inc|''country''}}||{{#invoke:DemoTemplate|flagc|China}}<br/>{{#invoke:DemoTemplate|flagg|inc|China}}
|-
|{{tlx|flagcountry|''country''}}||{{tnull|flagg|unce|''country''}}||{{#invoke:DemoTemplate|flagcountry|CHN}}<br/>{{#invoke:DemoTemplate|flagg|unce|CHN}}
|-
|{{tlx|flagdeco|''country''}}||{{tnull|flagg|uxx|''country''}}||{{#invoke:DemoTemplate|flagdeco|China}}<br/>{{#invoke:DemoTemplate|flagg|uxx|China}}
|-
|{{tlx|flagicon|''country''}}||{{tnull|flagg|cxx|''country''}}||{{#invoke:DemoTemplate|flagicon|China}}<br/>{{#invoke:DemoTemplate|flagg|cxx|China}}
|-
|{{tlx|flagicon image|''image''}}||{{tnull|flagg|uxx|image{{=}}''image''}}||{{#invoke:DemoTemplate|flagicon image|Flag of China.svg}}<br/>{{#invoke:DemoTemplate|flagg|uxx|image=Flag of China.svg}}
|-
|{{tlx|flaglink|''country''|''suffix''}}||{{tnull|flagg|unp|''country''|suff{{=}}''suffix''}}||{{#invoke:DemoTemplate|flaglink|China|at the Hopman Cup}}<br/>{{#invoke:DemoTemplate|flagg|unp|China|suff=at the Hopman Cup}}
|-
|{{tlx|flag+link|''prefix''|''country''}}||{{tnull|flagg|unp|''country''|pref{{=}}''prefix''}} (no existence check)||{{#invoke:DemoTemplate|flag+link|Agriculture in|China}}<br/>{{#invoke:DemoTemplate|flagg|unp|China|pref=Agriculture in}}
|-
|{{tlx|flaglist|''country''}}||{{tnull|flagg|usc|''country''}}||{{#invoke:DemoTemplate|flaglist|China}}<br/>{{#invoke:DemoTemplate|flagg|usc|China}}
|-
|{{tlx|flagof|''country''}}||{{tnull|flagg|unp|''country''|sz{{=}}l}}||{{#invoke:DemoTemplate|flagof|China}}<br/>{{#invoke:DemoTemplate|flagg|unp|China|sz=l}}
|-
|{{tlx|flagright|''country''}}||{{tnull|flagg|uncr|''country''}}||{{#invoke:DemoTemplate|flagright|China}}<br/>{{#invoke:DemoTemplate|flagg|uncr|China}}
|-
|{{tlx|flagu|''country''}}||{{tnull|flagg|unu|''country''}}||{{#invoke:DemoTemplate|flagu|China}}<br/>{{#invoke:DemoTemplate|flagg|unu|China}}
|-
|{{tlx|noflag|''country''}}||{{tnull|flagg|xnu|''country''}}||{{#invoke:DemoTemplate|noflag|China}}<br/>{{#invoke:DemoTemplate|flagg|xnu|China}}
|-
|{{tlx|noflag|&#91;&#91;''country''&#93;&#93;}}||{{tnull|flagg|xnc|''country''}}||{{#invoke:DemoTemplate|noflag|[[China]]}}<br/>{{#invoke:DemoTemplate|flagg|xnc|China}}
|}

=== Sports/military templates ===
The football templates are used as examples here; other sports that have separate templates work correspondingly.
{| class="wikitable"
!Template!!Corresponding {{tnull|flagg}} syntax!!Example
|-
|{{tlx|fb|''country''}}||{{tnull|flagg|unpe|''country''|avar{{=}}fb}}||{{#invoke:DemoTemplate|fb|China}}<br/>{{#invoke:DemoTemplate|flagg|unpe|China|avar=fb}}
|-
|{{tlx|fb|''country''|align{{=}}1}}||{{tnull|flagg|uspe|''country''|avar{{=}}fb|al{{=}}c}}||{{#invoke:DemoTemplate|fb|China|align=1}}<br/>{{#invoke:DemoTemplate|flagg|uspe|China|avar=fb|al=c}}
|-
|{{tlx|fb-big|''country''}}||{{tnull|flagg|ulpe|''country''|avar{{=}}fb|sz{{=}}l}}||{{#invoke:DemoTemplate|fb-big|China}}<br/>{{#invoke:DemoTemplate|flagg|ulpe|China|avar=fb|sz=l}}
|-
|{{tlx|fb-rt|''country''}}||{{tnull|flagg|unpre|''country''|avar{{=}}fb}}||{{#invoke:DemoTemplate|fb-rt|China}}<br/>{{#invoke:DemoTemplate|flagg|unpre|China|avar=fb}}
|-
|{{tlx|fbu|''age''|''country''}}||{{tnull|flagg|unpe|''country''|avar{{=}}fbu|age{{=}}''age''}}||{{#invoke:DemoTemplate|fbu|17|China}}<br/>{{#invoke:DemoTemplate|flagg|unpe|China|avar=fbu|age=17}}
|-
|{{tlx|fbw|''country''}}||{{tnull|flagg|unpe|''country''|avar{{=}}fbw}}||{{#invoke:DemoTemplate|fbw|China}}<br/>{{#invoke:DemoTemplate|flagg|unpe|China|avar=fbw}}
|-
|{{tlx|fbwu|''age''|''country''}}||{{tnull|flagg|unpe|''country''|avar{{=}}fbwu|age{{=}}''age''}}||{{#invoke:DemoTemplate|fbwu|17|China}}<br/>{{#invoke:DemoTemplate|flagg|unpe|China|avar=fbwu|age=17}}
|-
|{{tlx|army|''country''}}||{{tnull|flagg|unfe|''country''|avar{{=}}army}} (no automatic name override)||{{#invoke:DemoTemplate|army|China}}<br/>{{#invoke:DemoTemplate|flagg|unfe|China|avar=army}}
|-
|{{tlx|navy|''country''}}||{{tnull|flagg|unfe|''country''|avar{{=}}navy}} (no automatic name override)||{{#invoke:DemoTemplate|navy|China}}<br/>{{#invoke:DemoTemplate|flagg|unfe|China|avar=navy}}
|-
|{{tlx|air force|''country''}}||{{tnull|flagg|unfe|''country''|avar{{=}}air force}} (no automatic name override)||{{#invoke:DemoTemplate|air force|China}}<br/>{{#invoke:DemoTemplate|flagg|unfe|China|avar=air force}}
|}

{{#switch:{{SUBPAGENAME}}|doc|sandbox=|#default=
[[Category:Flag template system]]
}}

== See also ==
*[[User:SiBr4/Flagg tests|User:SiBr<sub>4</sub>/Flagg tests]] &mdash; extensive tests of the template's functions, which may also serve as additional examples