Template:Flag/doc - Revision history

Garlic: /* Valid settings */

2022-06-21T05:00:55Z

Valid settings

Garlic at 05:00, 21 June 2022

2022-06-21T05:00:16Z

Garlic at 02:15, 21 June 2022

2022-06-21T02:15:27Z

Efefknee: /* M */ + mo / Macao / Macau

2021-06-04T14:18:08Z

M: + mo / Macao / Macau

Garlic at 17:34, 11 May 2020

2020-05-11T17:34:06Z

Garlic at 17:33, 11 May 2020

2020-05-11T17:33:00Z

Garlic at 17:32, 11 May 2020

2020-05-11T17:32:21Z

Garlic at 17:31, 11 May 2020

2020-05-11T17:31:15Z

Garlic: /* Miscellaneous */

2020-05-11T16:41:20Z

Miscellaneous

Garlic: /* B */

2020-05-11T16:37:47Z

@@ Line 48: / Line 48: @@
   | style="width: 160px;" | [[Template:Flag/asean|ASEAN]]
 |-
   | [[Template:Flag/ukus|<code>ukus</code>]]
   | rowspan=2 | [[Template:Flag/english language|English Language]]
@@ Line 74: / Line 75: @@
   | [[Template:Flag/new zealand/australia|New Zealand/Australia]]
 |-
   | {{flag|sam}}
   | [[Template:Flag/sam|<code>sam</code>]]

@@ Line 48: / Line 48: @@
   | style="width: 160px;" | [[Template:Flag/asean|ASEAN]]
 |-
   | [[Template:Flag/ukus|<code>ukus</code>]]
   | rowspan=2 | [[Template:Flag/english language|English Language]]
@@ Line 75: / Line 63: @@
   | [[Template:Flag/north america|North America]]
 |-
   | {{flag|sam}}
   | [[Template:Flag/sam|<code>sam</code>]]

@@ Line 43: / Line 43: @@
 === Miscellaneous ===
 {| class="wikitable" style="text-align: center;"
-  | rowspan=4 style="width: 29px;" | {{flag|aunz}}
+|-
-  | rowspan=3 style="width: 44px;" | [[Template:Flag/aunz|<code>aunz</code>]]
+  | style="width: 29px;" | {{flag|asean}}
-  | style="width: 160px" | [[Template:Flag/australasia|Australasia]]
+  | style="width: 44px;" | [[Template:Flag/asean|<code>asean</code>]]
 |-
   | [[Template:Flag/oceania|Oceania]]

@@ Line 575: / Line 575: @@
 === M ===
 {| class="wikitable" style="text-align: center;"
 |-
   | style="width: 29px;" | {{flag|mg}}
@@ Line 649: / Line 655: @@
 |}
 {{Box|break|padding=1em}}
 === N ===
 {| class="wikitable" style="text-align: center;"

@@ Line 14: / Line 14: @@
   ! You get
 |-
-  ! Full name
+  ! style="font-weight:normal" | ''Full name''
   | <code><nowiki>{{flag|United Nations}}</nowiki></code>
   | {{flag|United Nations}}
 |-
-  ! Alternate name
+  ! style="font-weight:normal" | ''Alternate name''
   | <code><nowiki>{{flag|world}}</nowiki></code>
   | {{flag|world}}
 |-
-  ! Abbreviation
+  ! style="font-weight:normal" | ''Abbreviation''
   | <code><nowiki>{{flag|un}}</nowiki></code>
   | {{flag|un}}
 |-
-  ! No parameter
+  ! style="font-weight:normal" | ''No parameter''
   | <code><nowiki>{{flag|}}</nowiki></code>
   | {{flag|}}
 |-
-  ! Invalid parameter
+  ! style="font-weight:normal" | ''Invalid parameter''
   | <code><nowiki>{{flag|invalid}}</nowiki></code>
   | {{flag|invalid}}

@@ Line 10: / Line 10: @@
 == Examples ==
 {| class="wikitable" style="text-align: center;"
-  | style="background-color:transparent;border-top:hidden;border-left:hidden" |
+  | style="background-color:#ecfcf4;border-top:hidden;border-left:hidden" |
   ! You type
   ! You get

@@ Line 1: / Line 1: @@
 __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 ==
-<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.
 == 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:white;border-top:hidden;border-left:hidden" |
-  ! style="color: white; background-color: #1c1c1c" colspan=3 | You get
+ ! You type
 |-
-  | style="border-right:hidden" |
+  ! Abbreviation
-  | <code><nowiki>{{flag|antarctica}}</nowiki></code>
+  | <code><nowiki>{{flag|un}}</nowiki></code>
- | style="border-left:hidden" |
+  | {{flag|un}}
 |-
-  | style="border-right:hidden" |
+  ! No parameter
-  | <code><nowiki>{{flag|aq}}</nowiki></code>
+  | <code><nowiki>{{flag|}}</nowiki></code>
- | style="border-left:hidden" |
+  | {{flag|}}
 |-
-  | style="border-right:hidden" |
+  ! Invalid parameter
   | <code><nowiki>{{flag|invalid}}</nowiki></code>
   | {{flag|invalid}}
 |}
 == 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.
 {| 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]]
@@ Line 1,059: / Line 1,055: @@
 {{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]].
 *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. {{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

@@ Line 90: / Line 90: @@
   | {{flag|}}
   | [[Template:Flag/|<code></code>]]
-  | [[Template:Flag/|Unknown]]
+  | [[Template:Flag/unknown|Unknown]]
 |}
 {{Box|break|padding=1em}}

@@ Line 144: / Line 144: @@
 === B ===
 {| 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]]
 |-
   | {{flag|bh}}