Difference between revisions of "Template:Flag/doc"

From comp.tf
Jump to navigation Jump to search
 
(26 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
__NOTOC__
 
__NOTOC__
'''Template:Flag''' displays a flag icon that is 15px high and bordered. This template is used in conjunction with [[Template:Flag/abbr]], which defines the terms that can be used in this template. All of the flag images used in this template can be found at [[:Category:Flag Images]].
+
'''Template:Flag''' displays a flag icon.
 
== Usage ==
 
== Usage ==
<code><nowiki>{{flag|</nowiki>'''<nowiki>name</nowiki>'''<nowiki>}}</nowiki></code>
+
<code><nowiki>{{flag|</nowiki>'''<nowiki>1</nowiki>'''<nowiki>}}</nowiki></code>
=== name ===
+
=== 1 ===
This is the only parameter in the template and is used for defining which country's information should be used.
+
This is the only parameter in the template and is used for defining which country's flag will be shown.
*The data entered here will provide the icon with its image and caption/tool tip text.
+
* All valid settings for flags are listed in the tables below
*Appropriate settings for this parameter are listed in the table below.
+
* This parameter is case-insensitive.
*Any text entered should be fully lowercase.
+
 
*Any special characters (å, é, ì, ô, ū) are not used as they conflict with the wiki's file retrieving system.
 
*If there is no setting or the setting is invalid (i.e. not listed in the table below) the template will display a placeholder flag, {{flag}}. This is used to keep alignment proper in other templates or to indicate an unknown country.
 
 
== Examples ==
 
== Examples ==
{| class="wikitable" style="text-align: center; cell-padding: em;"
+
{| class="wikitable" style="text-align: center;"
  ! style="color: white; background-color: #1c1c1c" colspan=3 | You type
+
  | style="background-color:#ecfcf4;border-top:hidden;border-left:hidden" |
  ! style="color: white; background-color: #1c1c1c" colspan=3 | You get
+
! You type
 +
  ! You get
 
|-
 
|-
  | style="border-right:hidden" |
+
  ! style="font-weight:normal" | ''Full name''
  | <code><nowiki>{{flag|antarctica}}</nowiki></code>
+
  | <code><nowiki>{{flag|United Nations}}</nowiki></code>
| style="border-left:hidden" |
+
  | {{flag|United Nations}}
| style="border-right:hidden" |
 
  | {{flag|antarctica}}
 
| style="border-left:hidden" |
 
 
|-
 
|-
  | style="border-right:hidden" |
+
  ! style="font-weight:normal" | ''Alternate name''
  | <code><nowiki>{{flag|aq}}</nowiki></code>
+
  | <code><nowiki>{{flag|world}}</nowiki></code>
| style="border-left:hidden" |
+
  | {{flag|world}}
| style="border-right:hidden" |
 
  | {{flag|aq}}
 
| style="border-left:hidden" |
 
 
|-
 
|-
  | style="border-right:hidden" |
+
  ! style="font-weight:normal" | ''Abbreviation''
 +
| <code><nowiki>{{flag|un}}</nowiki></code>
 +
| {{flag|un}}
 +
|-
 +
! style="font-weight:normal" | ''No parameter''
 +
| <code><nowiki>{{flag|}}</nowiki></code>
 +
| {{flag|}}
 +
|-
 +
! style="font-weight:normal" | ''Invalid parameter''
 
  | <code><nowiki>{{flag|invalid}}</nowiki></code>
 
  | <code><nowiki>{{flag|invalid}}</nowiki></code>
| style="border-left:hidden" |
 
| style="border-right:hidden" |
 
 
  | {{flag|invalid}}
 
  | {{flag|invalid}}
| style="border-left:hidden" |
 
 
|}
 
|}
 
== Valid settings ==
 
== Valid settings ==
A flag can be displayed by either using a country's two letter abbreviation, another name for the country, or the full name of the country in the '''name''' parameter. An alternate list of two letter abbreviations for countries can be found [https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements here].
+
=== Note: United Kingdom flags ===
{{box|start|padding=4em}}
+
The individual flags of {{flag|uken}} England, {{flag|ukni}} Northern Ireland, {{flag|uksc}} Scotland, and {{flag|ukwa}} Wales should take preference in '''all possible circumstances''' over the {{flag|uk}} United Kingdom flag.
=== Alternate names ===
 
These names are additional to those listed in the tables.
 
*{{flag|aunz}} Australasia: <code>oceania</code>
 
*{{flag|bs}} The Bahamas: <code>bahamas</code>
 
*{{flag|cv}} Cape Verde: <code>cabo verde</code>
 
*{{flag|tl}} East Timor: <code>timor-leste</code>
 
*{{flag|ga}} Gambia: <code>the gambia</code>
 
*{{flag|ci}} Ivory Coast: <code>cote d'ivoire</code>
 
*{{flag|mo}} Macau: <code>macao</code>
 
*{{flag|pn}} Pitcairn: <code>pitcairn islands</code>
 
*{{flag|un}} United Nations: <code>global</code>, <code>international</code>, <code>world</code>
 
*{{flag|us}} United States: <code>united states of america</code>
 
{{box|break|padding=4em}}
 
 
 
=== Alternate abbreviations ===
 
These abbreviations are additional to those listed in the tables.
 
*{{flag|en}} England: <code>en</code>
 
*{{flag|usuk}} English Language: <code>ukus</code>
 
*{{flag|rsa}} South Africa: <code>rsa</code>
 
*{{flag|ae}} United Arab Emirates: <code>uae</code>
 
*{{flag|uk}} United Kingdom: <code>gb</code>
 
*{{flag|us}} United States: <code>usa</code>
 
*{{flag|wa}} Wales: <code>wa</code>
 
{{box|break}}
 
<div style="display:inline-block; width:500px;">
 
 
 
=== {{flag|uken}} {{flag|ukni}} {{flag|uksc}} {{flag|ukwa}} <small>vs.</small> {{flag|uk}} ===
 
The individual flags of '''{{flag|uken}} England''', '''{{flag|ukni}} Northern Ireland''', '''{{flag|uksc}} Scotland''', and '''{{flag|ukwa}} Wales''' should take preference in all possible circumstances over the '''{{flag|uk}} United Kingdom''' flag.
 
</div>
 
{{box|end}}
 
 
{| class=wikitable style="width: 100%; text-align: center;"
 
{| class=wikitable style="width: 100%; text-align: center;"
|[[Template:Flag#A | A]] · [[Template:Flag#B | B]] · [[Template:Flag#C | C]] · [[Template:Flag#D | D]] · [[Template:Flag#E | E]] · [[Template:Flag#F | F]] · [[Template:Flag#G | G]] · [[Template:Flag#H | H]] · [[Template:Flag#I | I]] · [[Template:Flag#J | J]] · [[Template:Flag#K | K]] · [[Template:Flag#L | L]] · [[Template:Flag#M | M]] · [[Template:Flag#N | N]] · [[Template:Flag#O | O]] · [[Template:Flag#P | P]] · [[Template:Flag#Q | Q]] · [[Template:Flag#R | R]] · [[Template:Flag#S | S]] · [[Template:Flag#T | T]] · [[Template:Flag#U | U]] · [[Template:Flag#V | V]] · [[Template:Flag#W | W]] · [[Template:Flag#X | X]] · [[Template:Flag#Y | Y]] · [[Template:Flag#Z | Z]]
+
|[[Template:Flag#Miscellaneous | Misc]] · [[Template:Flag#A | A]] · [[Template:Flag#B | B]] · [[Template:Flag#C | C]] · [[Template:Flag#D | D]] · [[Template:Flag#E | E]] · [[Template:Flag#F | F]] · [[Template:Flag#G | G]] · [[Template:Flag#H | H]] · [[Template:Flag#I | I]] · [[Template:Flag#J | J]] · [[Template:Flag#K | K]] · [[Template:Flag#L | L]] · [[Template:Flag#M | M]] · [[Template:Flag#N | N]] · [[Template:Flag#O | O]] · [[Template:Flag#P | P]] · [[Template:Flag#Q | Q]] · [[Template:Flag#R | R]] · [[Template:Flag#S | S]] · [[Template:Flag#T | T]] · [[Template:Flag#U | U]] · [[Template:Flag#V | V]] · [[Template:Flag#W | W]] · [[Template:Flag#X | X]] · [[Template:Flag#Y | Y]] · [[Template:Flag#Z | Z]]
 
|}
 
|}
 
{{Box|start|padding=1em}}
 
{{Box|start|padding=1em}}
 +
=== Miscellaneous ===
 +
{| class="wikitable" style="text-align: center;"
 +
|-
 +
| style="width: 29px;" | {{flag|asean}}
 +
| style="width: 44px;" | [[Template:Flag/asean|<code>asean</code>]]
 +
| style="width: 160px;" | [[Template:Flag/asean|ASEAN]]
 +
|-
 +
| rowspan=2 | {{flag|ukus}}
 +
| [[Template:Flag/ukus|<code>ukus</code>]]
 +
| rowspan=2 | [[Template:Flag/english language|English Language]]
 +
|-
 +
| [[Template:Flag/usuk|<code>usuk</code>]]
 +
|-
 +
| rowspan=2 | {{flag|eu}}
 +
| rowspan=2 | [[Template:Flag/eu|<code>eu</code>]]
 +
| [[Template:Flag/europe|Europe]]
 +
|-
 +
| [[Template:Flag/european union|European Union]]
 +
|-
 +
| {{flag|nam}}
 +
| [[Template:Flag/nam|<code>nam</code>]]
 +
| [[Template:Flag/north america|North America]]
 +
|-
 +
| rowspan=4 | {{flag|aunz}}
 +
| rowspan=3 | [[Template:Flag/aunz|<code>aunz</code>]]
 +
| [[Template:Flag/australasia|Australasia]]
 +
|-
 +
| [[Template:Flag/oceania|Oceania]]
 +
|-
 +
| [[Template:Flag/australia/new zealand|Australia/New Zealand]]
 +
|-
 +
| [[Template:Flag/nzau|<code>nzau</code>]]
 +
| [[Template:Flag/new zealand/australia|New Zealand/Australia]]
 +
|-
 +
| {{flag|sam}}
 +
| [[Template:Flag/sam|<code>sam</code>]]
 +
| [[Template:Flag/south america|South America]]
 +
|-
 +
| rowspan=4 | {{flag|un}}
 +
| rowspan=4 | [[Template:Flag/un|<code>un</code>]]
 +
| [[Template:Flag/united nations|United Nations]]
 +
|-
 +
| [[Template:Flag/global|Global]]
 +
|-
 +
| [[Template:Flag/international|International]]
 +
|-
 +
| [[Template:Flag/world|World]]
 +
|-
 +
| {{flag|}}
 +
| [[Template:Flag/|<code></code>]]
 +
| [[Template:Flag/unknown|Unknown]]
 +
|}
 +
{{Box|break|padding=1em}}
 +
 
=== A ===
 
=== A ===
 
{| class="wikitable" style="text-align: center;"
 
{| class="wikitable" style="text-align: center;"
Line 120: Line 142:
 
|}
 
|}
 
{{Box|break|padding=1em}}
 
{{Box|break|padding=1em}}
 +
 
=== B ===
 
=== B ===
 
{| class="wikitable" style="text-align: center;"
 
{| class="wikitable" style="text-align: center;"
  | style="width: 29px;" | {{flag|bs}}
+
  | rowspan=2 style="width: 29px;" | {{flag|bs}}
  | style="width: 44px;" | [[Template:Flag/bs|<code>bs</code>]]
+
  | rowspan=2 style="width: 44px;" | [[Template:Flag/bs|<code>bs</code>]]
  | style="width: 160px;" | [[Template:Flag/bahamas|The Bahamas]]
+
  | style="width: 160px;" | [[Template:Flag/bahamas|Bahamas]]
 +
|-
 +
| [[Template:Flag/the bahamas|The Bahamas]]
 
|-
 
|-
 
  | {{flag|bh}}
 
  | {{flag|bh}}
Line 206: Line 231:
 
  | [[Template:Flag/canada|Canada]]
 
  | [[Template:Flag/canada|Canada]]
 
|-
 
|-
  | {{flag|cv}}
+
  | rowspan=2 | {{flag|cv}}
  | [[Template:Flag/cv|<code>cv</code>]]
+
  | rowspan=2 | [[Template:Flag/cv|<code>cv</code>]]
 
  | [[Template:Flag/cape verde|Cape Verde]]
 
  | [[Template:Flag/cape verde|Cape Verde]]
 +
|-
 +
| [[Template:Flag/cabo verde|Cabo Verde]]
 
|-
 
|-
 
  | {{flag|cf}}
 
  | {{flag|cf}}
Line 233: Line 260:
 
  | [[Template:Flag/km|<code>km</code>]]
 
  | [[Template:Flag/km|<code>km</code>]]
 
  | [[Template:Flag/comoros|Comoros]]
 
  | [[Template:Flag/comoros|Comoros]]
|-
 
| {{flag|cd}}
 
| [[Template:Flag/cd|<code>cd</code>]]
 
| [[Template:Flag/democratic republic of the congo|Democratic Republic<br>of the Congo]]
 
|-
 
| {{flag|cg}}
 
| [[Template:Flag/cg|<code>cg</code>]]
 
| [[Template:Flag/republic of the congo|Republic of the Congo]]
 
 
|-
 
|-
 
  | {{flag|cr}}
 
  | {{flag|cr}}
Line 258: Line 277:
 
  | [[Template:Flag/cyprus|Cyprus]]
 
  | [[Template:Flag/cyprus|Cyprus]]
 
|-
 
|-
  | {{flag|cz}}
+
  | rowspan=2 | {{flag|cz}}
  | [[Template:Flag/cz|<code>cz</code>]]
+
  | rowspan=2 | [[Template:Flag/cz|<code>cz</code>]]
 
  | [[Template:Flag/czech republic|Czech Republic]]
 
  | [[Template:Flag/czech republic|Czech Republic]]
 
|-
 
|-
  | {{flag|ci}}
+
  | [[Template:Flag/czechia|Czechia]]
  | [[Template:Flag/ci|<code>ci</code>]]
+
|-
 +
| rowspan=2 | {{flag|ci}}
 +
  | rowspan=2 | [[Template:Flag/ci|<code>ci</code>]]
 
  | [[Template:Flag/côte d'ivoire|Côte d'Ivoire]]
 
  | [[Template:Flag/côte d'ivoire|Côte d'Ivoire]]
 +
|-
 +
| [[Template:Flag/ivory coast|Ivory Coast]]
 
|}
 
|}
 
{{Box|break|padding=1em}}
 
{{Box|break|padding=1em}}
Line 270: Line 293:
 
=== D ===
 
=== D ===
 
{| class="wikitable" style="text-align: center;"
 
{| class="wikitable" style="text-align: center;"
  | style="width: 29px;" | {{flag|dk}}
+
  | rowspan=2 style="width: 29px;" | {{flag|cd}}
  | style="width: 44px;" | [[Template:Flag/dk|<code>dk</code>]]
+
  | rowspan=2 style="width: 44px;" | [[Template:Flag/cd|<code>cd</code>]]
  | style="width: 160px;" | [[Template:Flag/denmark|Denmark]]
+
  | style="width: 160px;" | [[Template:Flag/democratic republic of the congo|Democratic Republic<br>of the Congo]]
 +
|-
 +
| [[Template:Flag/zaire|Zaire]]
 +
|-
 +
| {{flag|dk}}
 +
| [[Template:Flag/dk|<code>dk</code>]]
 +
| [[Template:Flag/denmark|Denmark]]
 
|-
 
|-
 
  | {{flag|dj}}
 
  | {{flag|dj}}
Line 290: Line 319:
 
{| class="wikitable" style="text-align: center;"
 
{| class="wikitable" style="text-align: center;"
 
|-
 
|-
  | style="width: 29px;" | {{flag|tl}}
+
  | rowspan=2 style="width: 29px;" | {{flag|tl}}
  | style="width: 44px;" | [[Template:Flag/tl|<code>tl</code>]]
+
  | rowspan=2 style="width: 44px;" | [[Template:Flag/tl|<code>tl</code>]]
 
  | style="width: 160px;" | [[Template:Flag/east timor|East Timor]]
 
  | style="width: 160px;" | [[Template:Flag/east timor|East Timor]]
 +
|-
 +
| [[Template:Flag/timor-leste|Timor-Leste]]
 
|-
 
|-
 
  | {{flag|ec}}
 
  | {{flag|ec}}
Line 306: Line 337:
 
  | [[Template:Flag/el salvador|El Salvador]]
 
  | [[Template:Flag/el salvador|El Salvador]]
 
|-
 
|-
  | {{flag|uken}}
+
  | rowspan=2 | {{flag|uken}}
 
  | [[Template:Flag/uken|<code>uken</code>]]
 
  | [[Template:Flag/uken|<code>uken</code>]]
  | [[Template:Flag/england|England]]
+
  | rowspan=2 | [[Template:Flag/england|England]]
 +
|-
 +
| [[Template:Flag/en|<code>en</code>]]
 
|-
 
|-
 
  | {{flag|gq}}
 
  | {{flag|gq}}
Line 322: Line 355:
 
  | [[Template:Flag/estonia|Estonia]]
 
  | [[Template:Flag/estonia|Estonia]]
 
|-
 
|-
  | {{flag|sz}}
+
  | rowspan=2 | {{flag|sz}}
  | [[Template:Flag/sz|<code>sz</code>]]
+
  | rowspan=2 | [[Template:Flag/sz|<code>sz</code>]]
 
  | [[Template:Flag/eswatini|Eswatini]]
 
  | [[Template:Flag/eswatini|Eswatini]]
 +
|-
 +
| [[Template:Flag/swaziland|Swaziland]]
 
|-
 
|-
 
  | {{flag|et}}
 
  | {{flag|et}}
 
  | [[Template:Flag/et|<code>et</code>]]
 
  | [[Template:Flag/et|<code>et</code>]]
 
  | [[Template:Flag/ethiopia|Ethiopia]]
 
  | [[Template:Flag/ethiopia|Ethiopia]]
|-
 
| {{flag|eu}}
 
| [[Template:Flag/eu|<code>eu</code>]]
 
| [[Template:Flag/europe|Europe]]
 
 
|}
 
|}
 
{{Box|break|padding=1em}}
 
{{Box|break|padding=1em}}
 +
 
=== F ===
 
=== F ===
 
{| class="wikitable" style="text-align: center;"
 
{| class="wikitable" style="text-align: center;"
Line 358: Line 390:
 
  | style="width: 160px;" | [[Template:Flag/gabon|Gabon]]
 
  | style="width: 160px;" | [[Template:Flag/gabon|Gabon]]
 
|-
 
|-
  | {{flag|gm}}
+
  | rowspan=2 | {{flag|gm}}
  | [[Template:Flag/gm|<code>gm</code>]]
+
  | rowspan=2 | [[Template:Flag/gm|<code>gm</code>]]
 +
| [[Template:Flag/the gambia|The Gambia]]
 +
|-
 
  | [[Template:Flag/gambia|Gambia]]
 
  | [[Template:Flag/gambia|Gambia]]
 
|-
 
|-
Line 403: Line 437:
 
|}
 
|}
 
{{Box|break|padding=1em}}
 
{{Box|break|padding=1em}}
 +
 
=== H ===
 
=== H ===
 
{| class="wikitable" style="text-align: center;"
 
{| class="wikitable" style="text-align: center;"
Line 545: Line 580:
 
=== M ===
 
=== M ===
 
{| class="wikitable" style="text-align: center;"
 
{| class="wikitable" style="text-align: center;"
 +
|-
 +
| rowspan=2 | {{flag|mo}}
 +
| rowspan=2 | [[Template:Flag/mo|<code>mo</code>]]
 +
| [[Template:Flag/macao|Macao]]
 +
|-
 +
| [[Template:Flag/macao|Macau]]
 
|-
 
|-
 
  | style="width: 29px;" | {{flag|mg}}
 
  | style="width: 29px;" | {{flag|mg}}
Line 619: Line 660:
 
|}
 
|}
 
{{Box|break|padding=1em}}
 
{{Box|break|padding=1em}}
 +
 
=== N ===
 
=== N ===
 
{| class="wikitable" style="text-align: center;"
 
{| class="wikitable" style="text-align: center;"
Line 634: Line 676:
 
  | [[Template:Flag/nepal|Nepal]]
 
  | [[Template:Flag/nepal|Nepal]]
 
|-
 
|-
  | {{flag|nl}}
+
  | rowspan=2 | {{flag|nl}}
  | [[Template:Flag/nl|<code>nl</code>]]
+
  | rowspan=2 | [[Template:Flag/nl|<code>nl</code>]]
 
  | [[Template:Flag/netherlands|Netherlands]]
 
  | [[Template:Flag/netherlands|Netherlands]]
 +
|-
 +
| [[Template:Flag/holland|Holland]]
 
|-
 
|-
 
  | {{flag|nz}}
 
  | {{flag|nz}}
Line 658: Line 702:
 
  | [[Template:Flag/north korea|North Korea]]
 
  | [[Template:Flag/north korea|North Korea]]
 
|-
 
|-
  | {{flag|mk}}
+
  | rowspan=2 | {{flag|mk}}
  | [[Template:Flag/mk|<code>mk</code>]]
+
  | rowspan=2 | [[Template:Flag/mk|<code>mk</code>]]
 +
| [[Template:Flag/macedonia|Macedonia]]
 +
|-
 
  | [[Template:Flag/north macedonia|North Macedonia]]
 
  | [[Template:Flag/north macedonia|North Macedonia]]
 
|-
 
|-
Line 671: Line 717:
 
|}
 
|}
 
{{Box|break|padding=1em}}
 
{{Box|break|padding=1em}}
 +
 
=== O ===
 
=== O ===
 
{| class="wikitable" style="text-align: center;"
 
{| class="wikitable" style="text-align: center;"
Line 738: Line 785:
 
{| class="wikitable" style="text-align: center;"
 
{| class="wikitable" style="text-align: center;"
 
|-
 
|-
  | style="width: 29px;" | {{flag|ro}}
+
  | rowspan=2 style="width: 29px;" | {{flag|cg}}
  | style="width: 44px;" | [[Template:Flag/|<code>ro</code>]]
+
  | rowspan=2 style="width: 44px;" | [[Template:Flag/cg|<code>cg</code>]]
  | style="width: 160px;" | [[Template:Flag/romania|Romania]]
+
  | style="width: 160px;" | [[Template:Flag/republic of the congo|Republic of the Congo]]
 +
|-
 +
| [[Template:Flag/congo|Congo]]
 +
|-
 +
| {{flag|ro}}
 +
| [[Template:Flag/ro|<code>ro</code>]]
 +
| [[Template:Flag/romania|Romania]]
 
|-
 
|-
 
  | {{flag|ru}}
 
  | {{flag|ru}}
Line 751: Line 804:
 
|}
 
|}
 
{{Box|break|padding=1em}}
 
{{Box|break|padding=1em}}
 +
 
=== S ===
 
=== S ===
 
{| class="wikitable" style="text-align: center;"
 
{| class="wikitable" style="text-align: center;"
Line 822: Line 876:
 
  | [[Template:Flag/somalia|Somalia]]
 
  | [[Template:Flag/somalia|Somalia]]
 
|-
 
|-
  | {{flag|za}}
+
  | rowspan=2 | {{flag|za}}
 
  | [[Template:Flag/za|<code>za</code>]]
 
  | [[Template:Flag/za|<code>za</code>]]
  | [[Template:Flag/south africa|South Africa]]
+
  | rowspan=2 | [[Template:Flag/south africa|South Africa]]
 
|-
 
|-
| {{flag|sam}}
+
  | [[Template:Flag/rsa|<code>rsa</code>]]
  | [[Template:Flag/sam|<code>sam</code>]]
 
| [[Template:Flag/south america|South America]]
 
 
|-
 
|-
 
  | {{flag|kr}}
 
  | {{flag|kr}}
Line 927: Line 979:
 
  | [[Template:Flag/ukraine|Ukraine]]
 
  | [[Template:Flag/ukraine|Ukraine]]
 
|-
 
|-
  | {{flag|ae}}
+
  | rowspan=2 | {{flag|ae}}
 
  | [[Template:Flag/ae|<code>ae</code>]]
 
  | [[Template:Flag/ae|<code>ae</code>]]
  | [[Template:Flag/united arab emirates|United Arab Emirates]]
+
  | rowspan=2 | [[Template:Flag/united arab emirates|United Arab Emirates]]
 
|-
 
|-
  | {{flag|uk}}
+
  | [[Template:Flag/uae|<code>uae</code>]]
 +
|-
 +
| rowspan=3 | {{flag|uk}}
 
  | [[Template:Flag/uk|<code>uk</code>]]
 
  | [[Template:Flag/uk|<code>uk</code>]]
 
  | [[Template:Flag/united kingdom|United Kingdom]]
 
  | [[Template:Flag/united kingdom|United Kingdom]]
 
|-
 
|-
  | {{flag|us}}
+
  | rowspan=2 | [[Template:Flag/gb|<code>gb</code>]]
 +
| [[Template:Flag/britain|Britain]]
 +
|-
 +
| [[Template:Flag/great britain|Great Britain]]
 +
|-
 +
| rowspan=2 | {{flag|us}}
 
  | [[Template:Flag/us|<code>us</code>]]
 
  | [[Template:Flag/us|<code>us</code>]]
 
  | [[Template:Flag/united states|United States]]
 
  | [[Template:Flag/united states|United States]]
 +
|-
 +
| [[Template:Flag/usa|<code>usa</code>]]
 +
| [[Template:Flag/united states of america|United States of America]]
 
|-
 
|-
 
  | {{flag|uy}}
 
  | {{flag|uy}}
Line 948: Line 1,010:
 
|}
 
|}
 
{{Box|break|padding=1em}}
 
{{Box|break|padding=1em}}
 +
 
=== V ===
 
=== V ===
 
{| class="wikitable" style="text-align: center;"
 
{| class="wikitable" style="text-align: center;"
Line 971: Line 1,034:
 
{| class="wikitable" style="text-align: center;"
 
{| class="wikitable" style="text-align: center;"
 
|-
 
|-
  | style="width: 29px;" | {{flag|ukwa}}
+
  | rowspan=2 style="width: 29px;" | {{flag|ukwa}}
  | style="width: 44px;" | [[Template:Flag/ukwa|<code>ukwa</code>]]
+
  | style="width: 44px;" | [[Template:Flag/wa|<code>wa</code>]]
  | style="width: 160px;" | [[Template:Flag/wales|Wales]]
+
  | rowspan=2 style="width: 160px;" | [[Template:Flag/wales|Wales]]
 +
|-
 +
| [[Template:Flag/ukwa|<code>ukwa</code>]]
 
|}
 
|}
 
{{Box|break|padding=1em}}
 
{{Box|break|padding=1em}}
 +
 
=== X ===
 
=== X ===
 
<div style="width:273px"></div><!-- Div to keep tables aligned. Delete this if adding a table -->
 
<div style="width:273px"></div><!-- Div to keep tables aligned. Delete this if adding a table -->
Line 1,001: Line 1,067:
 
{{Box|end}}
 
{{Box|end}}
  
 +
== Developer documentation ==
 +
=== How this template works ===
 +
# '''Template:Flag''' takes the input parameter and calls a sub-template at "Template:Flag/X". For example, <code><nowiki>{{flag|united nations}}</nowiki></code> will call [[Template:Flag/united nations]].
 +
# This sub-template then in turn calls [[Template:Flag icon]], supplying it with a single parameter (<code><nowiki>{{Flag icon|X}}</nowiki></code>). For example, Template:Flag/united nations supplies Template:Flag icon with the single parameter <code>United Nations</code>
 +
# Template:Flag icon calls for a flag image at "File:Flag of X.png", and applies formatting such as sizing and a 1px border. For example, if Template:Flag icon is given the parameter <code>United Nations</code>, it will supply [[:File:Flag of United Nations.png]] ({{flag|un}}).
 +
 +
* Many of the sub-templates (such as the abbreviations and alternate names) are simple redirects to a primary sub-template. For example, [[Template:Flag/un]], [[Template:Flag/global]], [[Template:Flag/international]] and [[Template:Flag/world]] all redirect to [[Template:Flag/united nations]]. Template:Flag/united nations is the primary sub-template which then calls Template:Flag icon.
  
== Adding a flag ==
+
=== How to add a flag ===
If you wish to add a flag, the following requirements must be followed
+
If you wish to add a flag, the following requirements must be followed:
=== Image size ===
+
==== Image size ====
 
*Width: equal or less than 23px
 
*Width: equal or less than 23px
 
*Height: equal or less than 15px
 
*Height: equal or less than 15px
 
*Aspect ratio: retained from source flag
 
*Aspect ratio: retained from source flag
 
If your flag is a custom flag (e.g. {{flag|nam}}), we recommend a 23x15px flag which has a 2:3 ratio.
 
If your flag is a custom flag (e.g. {{flag|nam}}), we recommend a 23x15px flag which has a 2:3 ratio.
=== Upload ===
+
==== Upload ====
*Your flag should be uploaded to <Code>File:Flag of <nowiki><fullflagname></nowiki>.png</code>
+
*Your flag should be uploaded to <Code>File:Flag of '''ProperFlagName'''.png</code>, where <code>'''ProperFlagName'''</code> is the full name of your flag with correct capitalization
*Make sure you add your flag to [[:Category:Flag Images]]
+
*Make sure you add your flag image to [[:Category:Flag Images]].
=== Update templates ===
+
==== Update templates ====
*[[Template:Flag/abbr]] controls abbreviations and flag names, add your flag with its appropriate abbreviation there
+
*Create a template at <code>Template:Flag/'''lowercaseflagname'''</code>, where <code>'''lowercaseflagname'''</code> is the full name of your flag in complete lowercase. This template should contain the code below:
*Update the appropriate documentation template at Template:Flag/doc/''FirstLetterOfFullFlagName'' (e.g. [[Template:Flag/doc/s]] for Switzerland)
+
<pre><nowiki>{{Flag icon|</nowiki>'''ProperFlagName'''<nowiki>}}<noinclude>[[Category:Flag sub-templates]]</noinclude></nowiki></pre>
 
+
*Create a template at <code>Template:Flag/'''abbr'''</code>, where <code>abbr</code> is the lowercase abbreviation of your flag. This template should be a simple redirect to the primary sub-template (<code>Template:Flag/'''lowercaseflagname'''</code>)
<noinclude>[[Category:Flag Documentation Templates]]</noinclude>
+
**If your template has any alternate names or abbreviations, create them as simple redirects to the primary sub-template as well
 +
*Add your flag to the correct table in the [[Template:Flag/doc|documentation template]].<noinclude>[[Category:Flag Documentation Templates]]</noinclude>

Latest revision as of 05:00, 21 June 2022

Template:Flag displays a flag icon.

Usage[edit]

{{flag|1}}

1[edit]

This is the only parameter in the template and is used for defining which country's flag will be shown.

  • All valid settings for flags are listed in the tables below
  • This parameter is case-insensitive.

Examples[edit]

You type You get
Full name {{flag|United Nations}} United Nations
Alternate name {{flag|world}} United Nations
Abbreviation {{flag|un}} United Nations
No parameter {{flag|}} Unknown
Invalid parameter {{flag|invalid}} Template:Flag/invalid

Valid settings[edit]

Note: United Kingdom flags[edit]

The individual flags of England England, Northern Ireland Northern Ireland, Scotland Scotland, and Wales Wales should take preference in all possible circumstances over the United Kingdom United Kingdom flag.

Misc · A · B · C · D · E · F · G · H · I · J · K · L · M · N · O · P · Q · R · S · T · U · V · W · X · Y · Z

O[edit]

Oman om Oman

X[edit]

Developer documentation[edit]

How this template works[edit]

  1. Template:Flag takes the input parameter and calls a sub-template at "Template:Flag/X". For example, {{flag|united nations}} will call Template:Flag/united nations.
  2. This sub-template then in turn calls Template:Flag icon, supplying it with a single parameter ({{Flag icon|X}}). For example, Template:Flag/united nations supplies Template:Flag icon with the single parameter United Nations
  3. Template:Flag icon calls for a flag image at "File:Flag of X.png", and applies formatting such as sizing and a 1px border. For example, if Template:Flag icon is given the parameter United Nations, it will supply File:Flag of United Nations.png (United Nations).

How to add a flag[edit]

If you wish to add a flag, the following requirements must be followed:

Image size[edit]

  • Width: equal or less than 23px
  • Height: equal or less than 15px
  • Aspect ratio: retained from source flag

If your flag is a custom flag (e.g. North America), we recommend a 23x15px flag which has a 2:3 ratio.

Upload[edit]

  • Your flag should be uploaded to File:Flag of ProperFlagName.png, where ProperFlagName is the full name of your flag with correct capitalization
  • Make sure you add your flag image to Category:Flag Images.

Update templates[edit]

  • Create a template at Template:Flag/lowercaseflagname, where lowercaseflagname is the full name of your flag in complete lowercase. This template should contain the code below:
{{Flag icon|'''ProperFlagName'''}}<noinclude>[[Category:Flag sub-templates]]</noinclude>
  • Create a template at Template:Flag/abbr, where abbr is the lowercase abbreviation of your flag. This template should be a simple redirect to the primary sub-template (Template:Flag/lowercaseflagname)
    • If your template has any alternate names or abbreviations, create them as simple redirects to the primary sub-template as well
  • Add your flag to the correct table in the documentation template.