Module:Flags/doc
 | This is a documentation subpage for Module:Flags. It may contain usage information, categories and other content that is not part of the original module page. |
All the logics of Template:Flags are handled here. This module works together with Module:Sandbox/QuimGil/FlagTranslations, where the flags data is maintained.
Features
Functionality implemented:
- Full name in English or the locale language: "Andorra".
- 2 letter code: "GB"
- 3 letter code: "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"
Roadmap
What is missing to reach feature parity with Template:Flagicon:
- m.fullName table needs key and values to become values and keys... As a way to accept different names (aliases) pointing to a same flag.
- Possibility of defining the full name of a flag in Commons by using "File:" in the table values.
- Nail down the best way to have localized names. Probably in a module apart, not to mess with the English tables.
- Also by users specifying "File:" in the parameter? Easy to implement but do we want so much freedom for editors?
- Performance testing.
- Extensive testing with copies of real pages, also for non-Latin scripts and Right-to-left languages.