Template:Flag/doc: Difference between revisions

From comp.tf
Jump to navigation Jump to search
← Older edit
VisualWikitext
 
(19 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="font-weight:normal" | ''Full name''
| <code><nowiki>{{flag|United Nations}}</nowiki></code>
| {{flag|United Nations}}
|-
! style="font-weight:normal" | ''Alternate name''
| <code><nowiki>{{flag|world}}</nowiki></code>
| {{flag|world}}
|-
|-
  | style="border-right:hidden" |
  ! style="font-weight:normal" | ''Abbreviation''
  | <code><nowiki>{{flag|antarctica}}</nowiki></code>
  | <code><nowiki>{{flag|un}}</nowiki></code>
| style="border-left:hidden" |
  | {{flag|un}}
| style="border-right:hidden" |
  | {{flag|antarctica}}
| style="border-left:hidden" |
|-
|-
  | style="border-right:hidden" |
  ! style="font-weight:normal" | ''No parameter''
  | <code><nowiki>{{flag|aq}}</nowiki></code>
  | <code><nowiki>{{flag|}}</nowiki></code>
| style="border-left:hidden" |
  | {{flag|}}
| style="border-right:hidden" |
  | {{flag|aq}}
| style="border-left:hidden" |
|-
|-
  | style="border-right:hidden" |
  ! 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#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]]
|[[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]]
Line 75: Line 43:
=== Miscellaneous ===
=== Miscellaneous ===
{| class="wikitable" style="text-align: center;"
{| class="wikitable" style="text-align: center;"
| style="width: 29px;" | {{flag|aunz}}
| style="width: 44px;" | [[Template:Flag/aunz|<code>aunz</code>]]
| style="width: 160px" | [[Template:Flag/aunz|Australia/New Zealand]]
|-
|-
  | {{flag|ukus}}
  | 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>]]
  | [[Template:Flag/ukus|<code>ukus</code>]]
  | [[Template:Flag/english language|English Language]]
  | rowspan=2 | [[Template:Flag/english language|English Language]]
|-
| [[Template:Flag/usuk|<code>usuk</code>]]
|-
|-
  | {{flag|eu}}
  | rowspan=2 | {{flag|eu}}
  | [[Template:Flag/eu|<code>eu</code>]]
  | rowspan=2 | [[Template:Flag/eu|<code>eu</code>]]
  | [[Template:Flag/europe|Europe]]
  | [[Template:Flag/europe|Europe]]
|-
| [[Template:Flag/european union|European Union]]
|-
|-
  | {{flag|nam}}
  | {{flag|nam}}
  | [[Template:Flag/nam|<code>nam</code>]]
  | [[Template:Flag/nam|<code>nam</code>]]
  | [[Template:Flag/north america|North America]]
  | [[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}}
  | {{flag|sam}}
Line 95: Line 79:
  | [[Template:Flag/south america|South America]]
  | [[Template:Flag/south america|South America]]
|-
|-
  | {{flag|un}}
  | rowspan=4 | {{flag|un}}
  | [[Template:Flag/un|<code>un</code>]]
  | rowspan=4 | [[Template:Flag/un|<code>un</code>]]
  | [[Template:Flag/united nations|United Nations]]
  | [[Template:Flag/united nations|United Nations]]
|-
| [[Template:Flag/global|Global]]
|-
| [[Template:Flag/international|International]]
|-
| [[Template:Flag/world|World]]
|-
|-
  | {{flag|}}
  | {{flag|}}
  | [[Template:Flag/|<code></code>]]
  | [[Template:Flag/|<code></code>]]
  | [[Template:Flag/|Unknown]]
  | [[Template:Flag/unknown|Unknown]]
|}
|}
{{Box|break|padding=1em}}
{{Box|break|padding=1em}}
=== A ===
=== A ===
{| class="wikitable" style="text-align: center;"
{| class="wikitable" style="text-align: center;"
Line 154: Line 145:
=== 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|Bahamas]]
  | style="width: 160px;" | [[Template:Flag/bahamas|Bahamas]]
|-
| [[Template:Flag/the bahamas|The Bahamas]]
|-
|-
  | {{flag|bh}}
  | {{flag|bh}}
Line 267: 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 292: 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 304: 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 324: 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 358: 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}}
Line 367: Line 366:
|}
|}
{{Box|break|padding=1em}}
{{Box|break|padding=1em}}
=== F ===
=== F ===
{| class="wikitable" style="text-align: center;"
{| class="wikitable" style="text-align: center;"
Line 390: 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 435: 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 577: 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 651: 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 666: 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 690: 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 703: 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 770: 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/ro|<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 964: Line 985:
  | [[Template:Flag/uae|<code>uae</code>]]
  | [[Template:Flag/uae|<code>uae</code>]]
|-
|-
  | rowspan=2 | {{flag|uk}}
  | rowspan=3 | {{flag|uk}}
  | [[Template:Flag/uk|<code>uk</code>]]
  | [[Template:Flag/uk|<code>uk</code>]]
  | rowspan=2 | [[Template:Flag/united kingdom|United Kingdom]]
  | [[Template:Flag/united kingdom|United Kingdom]]
|-
|-
  | [[Template:Flag/gb|<code>gb</code>]]
  | rowspan=2 | [[Template:Flag/gb|<code>gb</code>]]
| [[Template:Flag/britain|Britain]]
|-
| [[Template:Flag/great britain|Great Britain]]
|-
|-
  | rowspan=2 | {{flag|us}}
  | rowspan=2 | {{flag|us}}
  | [[Template:Flag/us|<code>us</code>]]
  | [[Template:Flag/us|<code>us</code>]]
  | rowspan=2 | [[Template:Flag/united states|United States]]
  | [[Template:Flag/united states|United States]]
|-
|-
  | [[Template:Flag/usa|<code>usa</code>]]
  | [[Template:Flag/usa|<code>usa</code>]]
| [[Template:Flag/united states of america|United States of America]]
|-
|-
  | {{flag|uy}}
  | {{flag|uy}}
Line 985: 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 1,009: Line 1,035:
|-
|-
  | rowspan=2 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>]]
  | rowspan=2 style="width: 160px;" | [[Template:Flag/wales|Wales]]
  | rowspan=2 style="width: 160px;" | [[Template:Flag/wales|Wales]]
|-
|-
  | [[Template:Flag/wa|<code>wa</code>]]
  | [[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,040: Line 1,067:
{{Box|end}}
{{Box|end}}


== Adding a flag ==
== Developer documentation ==
If you wish to add a flag, the following requirements must be followed
=== How this template works ===
=== Image size ===
# '''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.
 
=== How to add a flag ===
If you wish to add a flag, the following requirements must be followed:
==== 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 source]

{{flag|1}}

1[edit source]

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 source]

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 source]

Note: United Kingdom flags[edit source]

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

Developer documentation[edit source]

How this template works[edit source]

  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 source]

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

Image size[edit source]

  • 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 source]

  • 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 source]

  • 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.
Retrieved from "https://comp.tf/wiki/index.php?title=Template:Flag/doc&oldid=67155"