Module:Flags/doc

All the logics of Template:Flags are handled here. This module works together with Module:Flags/MasterData and Module:Flags/LocaleData, where the flags data is maintained.

Features
Functionality implemented:


 * Full name in English or the locale language: "Andorra".
 * 2 letter code - link points to full name: "AD"
 * 3 letter code - link points to full name: "AND"
 * Nepal and Ohio flags are shown without border.
 * When a name is not found in the list, attempts to offer a Commons image and a link e.g. "Berlin" or "WHO".
 * Size as in "size=44px" or "size=40x44px" can be defined in any position.
 * Nepal, Switzerland and Vatican City have a default size of 20x17px (for the rest it's 20x22px):
 * Variants for historical flags "1901" or "variant=1901" (for compatibility reasons)
 * Variants for labeled flags: "naval", "air force" and any other specified at FlagTranslations: "civil" - "naval-RMAS"
 * Variant / label flags not found in FlagTranslations return the Flag of None but still point to the right article: "whatever" - "quatsch"
 * Redirects (different names pointing to a same flag) are supported: "GB" - "UK"
 * Full Commons filenames can be defined in tables when they don't follow the "Flag of " syntax: "File:Flag Belgium brussels"
 * Localization: "Illes Balears" - "中華人民共和國"
 * Localization + variants: "Afganistan" + "1901" - "Regne Unit" + "civil"
 * Flags listed only in FlagTranslations always link to the local language article: parameter "Native Peoples of Colombia" links to "Pueblos Indígenas de Colombia"

Roadmap

 * Performance testing.
 * Extensive testing with copies of real pages, also for non-Latin scripts and Right-to-left languages.
 * Cover the rest of functionality offered by other flag templates.
 * Allow editors to define the year of the event, leaving to the template the task of finding the right flag.