Módulo:Flagg
This module depends on the following other modules: |
{{Flagg}}
(flag general) is a flag template with variable output format. Using Lua instead of the standard mechanism, it allows overriding the image name and link target, and works even if a country data template for an entity does not exist (without using any expensive functions).
The template is not intended to fully supersede any specific flag templates it can simulate (see below), but can be useful for formats for which no template exists, or if its additional options are needed.
Parameters[editar código]
Aliases (alternatives) for each parameter or value are given in square brackets.
Format (first unnamed parameter)[editar código]
The first parameter is an alphabetic code specifying the output format. The first letter concerns the image, the second the separator, and the third the country name. The parameter is fully case-insensitive.
If any position in the parameter value is missing or has a character not corresponding to an option below, the options marked as default will be used; e.g. a first parameter equal to La página Plantilla:Mono/styles.css debe tener el modelo de contenido "CSS expurgado" para TemplateStyles (el modelo de contenido que tiene actualmente es "texto wiki").i, La página Plantilla:Mono/styles.css debe tener el modelo de contenido "CSS expurgado" para TemplateStyles (el modelo de contenido que tiene actualmente es "texto wiki").i** or La página Plantilla:Mono/styles.css debe tener el modelo de contenido "CSS expurgado" para TemplateStyles (el modelo de contenido que tiene actualmente es "texto wiki").izz will be read as La página Plantilla:Mono/styles.css debe tener el modelo de contenido "CSS expurgado" para TemplateStyles (el modelo de contenido que tiene actualmente es "texto wiki").isc.
First letter: Image
Letter | Meaning | Description | Example |
---|---|---|---|
La página Plantilla:Mono/styles.css debe tener el modelo de contenido "CSS expurgado" para TemplateStyles (el modelo de contenido que tiene actualmente es "texto wiki").u | unlinked | Image is not linked (default). | {{flagg|uxx|France}} →
|
La página Plantilla:Mono/styles.css debe tener el modelo de contenido "CSS expurgado" para TemplateStyles (el modelo de contenido que tiene actualmente es "texto wiki").c | country | Image links to country/entity page. | {{flagg|cxx|France}} →
|
La página Plantilla:Mono/styles.css debe tener el modelo de contenido "CSS expurgado" para TemplateStyles (el modelo de contenido que tiene actualmente es "texto wiki").p [La página Plantilla:Mono/styles.css debe tener el modelo de contenido "CSS expurgado" para TemplateStyles (el modelo de contenido que tiene actualmente es "texto wiki").f] | prefix/suffix | Image links to country name with prefixed and/or suffixed text (default "Flag of ..."), set using |pref= and |suff= (see below). |
{{flagg|pxx|France}} →
|
La página Plantilla:Mono/styles.css debe tener el modelo de contenido "CSS expurgado" para TemplateStyles (el modelo de contenido que tiene actualmente es "texto wiki").i | image page | Image links to file description page; use this for non-public-domain images, for which attribution is required. | {{flagg|ixx|France}} →
|
La página Plantilla:Mono/styles.css debe tener el modelo de contenido "CSS expurgado" para TemplateStyles (el modelo de contenido que tiene actualmente es "texto wiki").d | data template | Image links to the used country data template, for use in discussion/documentation. Automatically adds redirect=no if link is a redirect. |
{{flagg|dxx|France}} →
|
La página Plantilla:Mono/styles.css debe tener el modelo de contenido "CSS expurgado" para TemplateStyles (el modelo de contenido que tiene actualmente es "texto wiki").x | X mark | No image is displayed. If the second letter is anything other than La página Plantilla:Mono/styles.css debe tener el modelo de contenido "CSS expurgado" para TemplateStyles (el modelo de contenido que tiene actualmente es "texto wiki").x, and La página Plantilla:Mono/styles.css debe tener el modelo de contenido "CSS expurgado" para TemplateStyles (el modelo de contenido que tiene actualmente es "texto wiki").o is not set, an unlinked transparent image is actually used to preserve the spacing. | {{flagg|xnx|France}} →
|
Second letter: Separator
Letter | Meaning | Description | Example | |
---|---|---|---|---|
La página Plantilla:Mono/styles.css debe tener el modelo de contenido "CSS expurgado" para TemplateStyles (el modelo de contenido que tiene actualmente es "texto wiki").s | span box | The flag image is put in a fixed-width <span> tag, meaning the country names are aligned in vertical lists; see documentation of {{Flaglist}} (default). |
{{flagg|usu|Niger}} → Niger
| |
La página Plantilla:Mono/styles.css debe tener el modelo de contenido "CSS expurgado" para TemplateStyles (el modelo de contenido que tiene actualmente es "texto wiki").n | non-breaking space | A non-breaking space ( ) is used, like in most flag templates, including {{flag}} . Note that does not actually prevent wrapping between image and text in all browsers; use La página Plantilla:Mono/styles.css debe tener el modelo de contenido "CSS expurgado" para TemplateStyles (el modelo de contenido que tiene actualmente es "texto wiki").w as described below if needed. |
{{flagg|unu|Niger}} → Niger
| |
La página Plantilla:Mono/styles.css debe tener el modelo de contenido "CSS expurgado" para TemplateStyles (el modelo de contenido que tiene actualmente es "texto wiki").l | line break | A line break (<br/> ) is used as separator. |
{{flagg|ulu|Niger}} → Niger | |
La página Plantilla:Mono/styles.css debe tener el modelo de contenido "CSS expurgado" para TemplateStyles (el modelo de contenido que tiene actualmente es "texto wiki").t | table cell | A table cell separator (two pipes) is used. | Niger | |
La página Plantilla:Mono/styles.css debe tener el modelo de contenido "CSS expurgado" para TemplateStyles (el modelo de contenido que tiene actualmente es "texto wiki").x | X mark | No separator is used. | {{flagg|uxu|Niger}} → Niger
|
Third letter: Name
Letter | Meaning | Description | Example |
---|---|---|---|
La página Plantilla:Mono/styles.css debe tener el modelo de contenido "CSS expurgado" para TemplateStyles (el modelo de contenido que tiene actualmente es "texto wiki").c | country | The country name links to the main country/entity page (default). | {{flagg|xxc|Chile}} → Chile
|
La página Plantilla:Mono/styles.css debe tener el modelo de contenido "CSS expurgado" para TemplateStyles (el modelo de contenido que tiene actualmente es "texto wiki").p | prefix/suffix | The country name links to the country page with prefixed or suffixed text (default "Flag of ..."), set using |pref= and |suff= (see below). |
{{flagg|xxp|Chile}} → Chile
|
La página Plantilla:Mono/styles.css debe tener el modelo de contenido "CSS expurgado" para TemplateStyles (el modelo de contenido que tiene actualmente es "texto wiki").f | full prefix/suffix | Same as La página Plantilla:Mono/styles.css debe tener el modelo de contenido "CSS expurgado" para TemplateStyles (el modelo de contenido que tiene actualmente es "texto wiki").p, except that the prefix and/or suffix is/are displayed. | {{flagg|xxf|Chile}} → Flag of Chile
|
La página Plantilla:Mono/styles.css debe tener el modelo de contenido "CSS expurgado" para TemplateStyles (el modelo de contenido que tiene actualmente es "texto wiki").b | both country and prefix/suffix | Combined country link and prefix/suffix link: country name links to country page, while prefix and/or suffix link(s) to prefixed/suffixed title. | {{flagg|xxb|Chile}} → Flag of Chile
|
La página Plantilla:Mono/styles.css debe tener el modelo de contenido "CSS expurgado" para TemplateStyles (el modelo de contenido que tiene actualmente es "texto wiki").u | unlinked (cf. {{flagu}} ) |
The country name is displayed as plain text, without link. | {{flagg|xxu|Chile}} → Chile
|
La página Plantilla:Mono/styles.css debe tener el modelo de contenido "CSS expurgado" para TemplateStyles (el modelo de contenido que tiene actualmente es "texto wiki").d | data template | Country name is linked to the used country data template, for use in discussion/documentation. Automatically adds redirect=no if a redirect is used. |
{{flagg|xxd|Chile}} → Chile
|
La página Plantilla:Mono/styles.css debe tener el modelo de contenido "CSS expurgado" para TemplateStyles (el modelo de contenido que tiene actualmente es "texto wiki").x | X mark | No text is displayed. | {{flagg|xxx|Chile}} →
|
Some additional options can be enabled by appending the following letters to the three-letter code in any order:
Letter | Description | Example |
---|---|---|
La página Plantilla:Mono/styles.css debe tener el modelo de contenido "CSS expurgado" para TemplateStyles (el modelo de contenido que tiene actualmente es "texto wiki").a | Adds the country name (the "name" parameter, or if unset the second unnamed parameter) as alt text and mouseover for the image. If |alt= is used for a custom alt/mouseover text, this does not need to be separately set. |
{{flagg|uxxa|Pakistan}} →
|
La página Plantilla:Mono/styles.css debe tener el modelo de contenido "CSS expurgado" para TemplateStyles (el modelo de contenido que tiene actualmente es "texto wiki").b | Blanks the text portion if a flag is not found. | {{flagg|uncb|Xanadu}} → Compare with: {{flagg|unc|Xanadu}} → Xanadu
|
La página Plantilla:Mono/styles.css debe tener el modelo de contenido "CSS expurgado" para TemplateStyles (el modelo de contenido que tiene actualmente es "texto wiki").e | Uses the name set in the country data template (rather than the first parameter) as display name, like in {{flagcountry}} (i.e. expands abbreviated forms). |
{{flagg|unue|PAK}} → Pakistan
|
La página Plantilla:Mono/styles.css debe tener el modelo de contenido "CSS expurgado" para TemplateStyles (el modelo de contenido que tiene actualmente es "texto wiki").f | If the prefixed/suffixed article name doesn't exist, fallback to linking to the non-prefixed/suffixed page. This may be expensive, and the number of time it can be used on single page is limited. | {{flagg|psff|Egypt|pref=Flag templates in}} → Flag templates in EgyptCompare with: {{flagg|psf|Egypt|pref=Flag templates in}} → Flag templates in Egypt
|
La página Plantilla:Mono/styles.css debe tener el modelo de contenido "CSS expurgado" para TemplateStyles (el modelo de contenido que tiene actualmente es "texto wiki").l | Adds the link name (as defined by the "image" parameter) as alt text and mouseover for the image. If |alt= is used for a custom alt/mouseover text, this does not need to be separately set. |
{{flagg|cxxl|PAK}} → Compare with: {{flagg|cxxa|PAK}} →
|
La página Plantilla:Mono/styles.css debe tener el modelo de contenido "CSS expurgado" para TemplateStyles (el modelo de contenido que tiene actualmente es "texto wiki").o | Omits the image and spacing in case the image is an invisible placeholder, i.e., only include the spacing if a flag is displayed. Useful for inline/standalone usages or horizontal lists, where name alignment is not needed. | {{flagg|unuo|Pakistan|image=}} → PakistanCompare with: {{flagg|unu|Pakistan|image=}} → Pakistan
|
La página Plantilla:Mono/styles.css debe tener el modelo de contenido "CSS expurgado" para TemplateStyles (el modelo de contenido que tiene actualmente es "texto wiki").r | Reverses the order of the elements, putting the image to the right of the name; cf. {{flagright}} . Doesn't affect the order of letters in the format code. |
{{flagg|uncr|Pakistan}} → Pakistan
|
La página Plantilla:Mono/styles.css debe tener el modelo de contenido "CSS expurgado" para TemplateStyles (el modelo de contenido que tiene actualmente es "texto wiki").w | Avoids wrapping by adding <span class="nowrap">...</span> around the output. |
{{flagg|unuw|Pakistan}} → Pakistan
|
Entity (second unnamed parameter)[editar código]
The second parameter is the country or entity name. The template attempts to read the flag and link data from "Template:Country data country"; if that does not exist, the same parameter will be used as default country link and no automatic image will be displayed. The parameter also defines the default displayed country name, if the La página Plantilla:Mono/styles.css debe tener el modelo de contenido "CSS expurgado" para TemplateStyles (el modelo de contenido que tiene actualmente es "texto wiki").e option above is not used.
Image parameters[editar código]
|variant=
[third unnamed parameter]- Specifies a variant flag image, as defined and documented in each entity's data template. For example,
{{flagg|ixx|Germany|naval}}
→ uses the "naval" variant of Template:Country data Germany. |image=
- Custom image name, with or without the "File:" namespace prefix. Can be used if the wanted image is not available as variant for the entity (you can alternatively request it be added at the respective data template's talk page), or if no data template exists. Set to "none" ["blank", empty string] to use an unlinked transparent image (functionally identical to the La página Plantilla:Mono/styles.css debe tener el modelo de contenido "CSS expurgado" para TemplateStyles (el modelo de contenido que tiene actualmente es "texto wiki").x format).
|size=
[|sz=
]- Sets the image size; default is 23×15 pixels (larger for some entities). You can use an explicit size in pixels (e.g. 30x20px; the "px" suffix is optional) or one of the relative sizes "xs" (half the default dimensions), "s", "m", "l" and "xl" (twice the default size).
|border=
- By default, the flag icon includes a border, except if it is disabled in the entity's country data template.
|border=
can be set to "yes" ["y", "1"] to force a border when excluded by default, or "no" ["n", "0", empty string] to prevent one. |align=
[|al=
]- Set to "left" ["l"], "center" ["centre", "c", "middle", "m"] or "right" ["r"] to set the alignment of the image for the span box (La página Plantilla:Mono/styles.css debe tener el modelo de contenido "CSS expurgado" para TemplateStyles (el modelo de contenido que tiene actualmente es "texto wiki").s) and table cell (La página Plantilla:Mono/styles.css debe tener el modelo de contenido "CSS expurgado" para TemplateStyles (el modelo de contenido que tiene actualmente es "texto wiki").t) formats. For La página Plantilla:Mono/styles.css debe tener el modelo de contenido "CSS expurgado" para TemplateStyles (el modelo de contenido que tiene actualmente es "texto wiki").t, the default is center; for La página Plantilla:Mono/styles.css debe tener el modelo de contenido "CSS expurgado" para TemplateStyles (el modelo de contenido que tiene actualmente es "texto wiki").s, it is right-aligned if La página Plantilla:Mono/styles.css debe tener el modelo de contenido "CSS expurgado" para TemplateStyles (el modelo de contenido que tiene actualmente es "texto wiki").r is set, else left-aligned.
|width=
[|w=
]- Sets the width of the span box surrounding the image for the span box (La página Plantilla:Mono/styles.css debe tener el modelo de contenido "CSS expurgado" para TemplateStyles (el modelo de contenido que tiene actualmente es "texto wiki").s) format, in pixels, without the "px" suffix. The default is calculated by Module:Flaglist and depends on the image size.
|alt=
- Sets alt text and mouseover text for the flag image, if it is for information rather than just decoration. If the wanted text is equal to the entity name, use the La página Plantilla:Mono/styles.css debe tener el modelo de contenido "CSS expurgado" para TemplateStyles (el modelo de contenido que tiene actualmente es "texto wiki").a option described above.
|ilink=
- Overrides the link target of the image (only use if none of the image formats above allow linking to the desired page).
|noredlink=no
- Displays a red link to the missing country data template instead of a placeholder image. Defaults to "yes" (no red link displayed).
|missingcategory=category name
- Adds the page to category name if the image if the country data is missing.
Text and link parameters[editar código]
|name=
- Changes the displayed country name. Note that with the La página Plantilla:Mono/styles.css debe tener el modelo de contenido "CSS expurgado" para TemplateStyles (el modelo de contenido que tiene actualmente es "texto wiki").f format, this includes the prefix and/or suffix.
|clink=
[|link=
]- Overwrites the link to the country article; this is also used to construct the prefix/suffix link for the La página Plantilla:Mono/styles.css debe tener el modelo de contenido "CSS expurgado" para TemplateStyles (el modelo de contenido que tiene actualmente es "texto wiki").f, La página Plantilla:Mono/styles.css debe tener el modelo de contenido "CSS expurgado" para TemplateStyles (el modelo de contenido que tiene actualmente es "texto wiki").p and La página Plantilla:Mono/styles.css debe tener el modelo de contenido "CSS expurgado" para TemplateStyles (el modelo de contenido que tiene actualmente es "texto wiki").b options.
|pref=
,|suff=
,|plink=
|pref=
and|suff=
set the prefix and suffix to use for the prefix/suffix links (format letters La página Plantilla:Mono/styles.css debe tener el modelo de contenido "CSS expurgado" para TemplateStyles (el modelo de contenido que tiene actualmente es "texto wiki").f, La página Plantilla:Mono/styles.css debe tener el modelo de contenido "CSS expurgado" para TemplateStyles (el modelo de contenido que tiene actualmente es "texto wiki").p and La página Plantilla:Mono/styles.css debe tener el modelo de contenido "CSS expurgado" para TemplateStyles (el modelo de contenido que tiene actualmente es "texto wiki").b). The default, if neither is specified, is "Flag of" as prefix (cf.{{flagof}}
) and no suffix.|plink=
can be used to override the combined link.|the=
- Set to "yes" ["y", "1"] to include the article "the" before the country name in the prefix/suffix links. Example:
{{flagg|usf|Philippines|the=1}}
→ Flag of the Philippines. Use|pthe=
if the link needs "the" but the name doesn't, and|nthe=
if the name needs it but the link doesn't. |section=
- Links to a section of the linked article without displaying the section name. If both a country link and a prefix/suffix link are used, use
|csection=
for a section of the country article, and|psection=
for a section of the prefixed/suffixed article. |altvar=
[|avar=
],|age=
- Enables using one of a set of standard suffixes for linking to sports teams and militaries. The altvar and suffix data is loaded from Module:Flagg/Altvar data. The possible parameter values are the base names of the corresponding specialized templates; alias values from full sports names exist (see examples below and data page). For some entities this also changes the image to a variant specific to a sport or military branch; for example,
{{flagg|usp|Ireland|avar=ru}}
→ Ireland uses the IRFU flag to represent the Irish rugby union team. For youth teams in some sports (see the data page), the age limit must be additionally set using|age=
. |nalign=
[|nal=
]- Sets the alignment of the text in table cell format (La página Plantilla:Mono/styles.css debe tener el modelo de contenido "CSS expurgado" para TemplateStyles (el modelo de contenido que tiene actualmente es "texto wiki").t). The default is left; the possible values are the same as for
|align=
. |text=
- Overrides the entire text; only use when necessary for any nonstandard formats. Alternatively, you can set the third letter of the format parameter to La página Plantilla:Mono/styles.css debe tener el modelo de contenido "CSS expurgado" para TemplateStyles (el modelo de contenido que tiene actualmente es "texto wiki").x (no text) and add custom text outside the template.
|nodata=y
- Overrides attempts to use the corresponding
{{country data ...}}
template, which is useful when the corresponding data template doesn't exist.
Examples[editar código]
Formats:
{{flagg|usc|Fiji}}
→ Fiji (default format){{flagg||Fiji}}
→ Fiji (default format){{flagg|pnbr|Fiji}}
→ Flag of Fiji<span style="display:inline-block;text-align:center;">{{flagg|ilf|Fiji|sz=xl}}</span>
→
Flag of Fiji
Table format & alignment:
{{flagg|utu|Jamaica}} |
Jamaica | |
{{flagg|utur|Jamaica}} |
Jamaica | |
{{flagg|utu|Jamaica|al=l|nal=l}} |
Jamaica | |
{{flagg|utu|Jamaica|al=c|nal=c}} |
Jamaica | |
{{flagg|utu|Jamaica|al=r|nal=r}} |
Jamaica |
{{flagg|usu|Switzerland}}
→ Switzerland{{flagg|usu|Switzerland|al=l}}
→ Switzerland{{flagg|usu|Switzerland|al=c}}
→ Switzerland{{flagg|usu|Switzerland|al=r}}
→ Switzerland
Standard image & name parameters:
{{flagg|isc|Myanmar}}
→ Myanmar{{flagg|isc|Myanmar|border=}}
→ Myanmar{{flagg|isc|Myanmar|1974}}
→ Myanmar{{flagg|isc|Myanmar|variant=1974}}
→ Myanmar{{flagg|isc|Myanmar|name=Burma|variant=1974}}
→ Burma{{flagg|isc|Burma|variant=1974}}
→ Burma{{flagg|isc|Myanmar|sz=30}}
→ Myanmar{{flagg|isc|Myanmar|size=30}}
→ Myanmar{{flagg|isc|Myanmar|size=30px}}
→ Myanmar{{flagg|isc|Myanmar|size=30x18px}}
→ Myanmar{{flagg|isc|Myanmar|size=xs}}
→ Myanmar{{flagg|isc|Myanmar|size=xl}}
→ Myanmar{{flagg|isc|Myanmar|width=30|size=xs}}
→ Myanmar{{flagg|isc|Myanmar|image=}}
→ Myanmar{{flagg|isc|Myanmar|image=Flag of None.svg}}
→ Myanmar{{flagg|isc|Myanmar|image=File:Flag of None.svg}}
→ Myanmar
Links and altvars:
{{flagg|psp|Egypt}}
→ Egypt{{flagg|psf|Egypt}}
→ Flag of Egypt{{flagg|psb|Egypt}}
→ Flag of Egypt{{flagg|psb|Philippines|the=1}}
→ Flag of the Philippines{{flagg|csc|Egypt|section=History}}
→ Egypt{{flagg|csb|Egypt|csection=History}}
→ Flag of Egypt{{flagg|psb|Egypt|psection=Kingdom of Egypt (1922–1953)|variant=1922}}
→ Flag of Egypt{{flagg|psb|Egypt|plink=List of Egyptian flags}}
→ Flag of Egypt{{flagg|psf|Egypt|pref=History of}}
→ History of Egypt{{flagg|psp|Egypt|suff=at the Olympics}}
→ Egypt{{flagg|psp|Egypt|avar=fb}}
→ Egypt{{flagg|psp|Egypt|avar=football}}
→ Egypt{{flagg|psp|Egypt|avar=fbu|age=20}}
→ Egypt{{flagg|psf|Egypt|avar=navy}}
→ Egypt Navy
Non-existing data template:
{{flagg|isc|Belfast|nodata=1}}
→ Belfast{{flagg|isc|Belfast|image=Flag of Belfast.svg|nodata=1}}
→ Belfast
Comparison with other templates[editar código]
These "specialized" templates predate Flagg, and while most do not have options for custom links and images, they are probably faster because they only do two transclusions without invoking Lua.
General templates[editar código]
Template | Corresponding {{flagg}} syntax |
Example |
---|---|---|
{{flag|country}} |
{{flagg|uncb|country}} |
{{flag|China}} → China{{flagg|unc|China}} → China
|
{{flagbig|country}} |
{{flagg|ulc|country|sz=l}} |
{{flagbig|China}} → China {{flagg|ulc|China|sz=l}} → China |
{{flagc|country}} |
{{flagg|inc|country}} |
{{flagc|China}} → China{{flagg|inc|China}} → China
|
{{flagcountry|country}} |
{{flagg|unce|country}} |
{{flagcountry|CHN}} → China{{flagg|unce|CHN}} → China
|
{{flagdeco|country}} |
{{flagg|uxxo|country}} |
{{flagdeco|China}} → {{flagg|uxx|China}} →
|
{{flagicon|country}} |
{{flagg|cxxlo|country}} |
{{flagicon|China}} → {{flagg|cxxlo|China}} →
|
{{flagicon image|image}} |
{{flagg|uxx|image=image}} |
{{flagicon image|Flag of China.svg}} → {{flagg|uxx|image=Flag of China.svg}} →
|
{{flaglink|country|suffix}} |
{{flagg|unp|country|suff=suffix}} |
{{flaglink|China|at the Hopman Cup}} → China{{flagg|unp|China|suff=at the Hopman Cup}} → China
|
{{flag+link|prefix|country}} |
{{flagg|unp|country|pref=prefix}} (no existence check) |
{{flag+link|Agriculture in|China}} → China{{flagg|unp|China|pref=Agriculture in}} → China
|
{{flaglist|country}} |
{{flagg|usc|country}} |
{{flaglist|China}} → China{{flagg|usc|China}} → China
|
{{flagof|country}} |
{{flagg|unp|country|sz=l}} |
{{flagof|China}} → China{{flagg|unp|China|sz=l}} → China
|
{{flagright|country}} |
{{flagg|uncr|country}} |
{{flagright|China}} → China {{flagg|uncr|China}} → China
|
{{flagu|country}} |
{{flagg|unu|country}} |
{{flagu|China}} → China{{flagg|unu|China}} → China
|
{{noflag|country}} |
{{flagg|xnu|country}} |
{{noflag|China}} → China{{flagg|xnu|China}} → China
|
{{noflag|[[country]]}} |
{{flagg|xnc|country}} |
{{noflag|[[China]]}} → China{{flagg|xnc|China}} → China
|
Sports/military templates[editar código]
The football templates are used as examples here; other sports that have separate templates work correspondingly.
Template | Corresponding {{flagg}} syntax |
Example |
---|---|---|
{{fb|country}} |
{{flagg|unpe|country|avar=fb}} |
{{fb|China}} → China PR{{flagg|unpe|China|avar=fb}} → China PR
|
{{fb|country|align=1}} |
{{flagg|uspe|country|avar=fb|al=c}} |
{{fb|China|align=1}} → China PR{{flagg|uspe|China|avar=fb|al=c}} → China PR
|
{{fb-big|country}} |
{{flagg|ulpe|country|avar=fb|sz=l}} |
{{fb-big|China}} → China PR {{flagg|ulpe|China|avar=fb|sz=l}} → China PR |
{{fb-rt|country}} |
{{flagg|unpre|country|avar=fb}} |
{{fb-rt|China}} → China PR {{flagg|unpre|China|avar=fb}} → China PR
|
{{fbu|age|country}} |
{{flagg|unpe|country|avar=fbu|age=age}} |
{{fbu|17|China}} → China PR{{flagg|unpe|China|avar=fbu|age=17}} → China PR
|
{{fbw|country}} |
{{flagg|unpe|country|avar=fbw}} |
{{fbw|China}} → China PR{{flagg|unpe|China|avar=fbw}} → China PR
|
{{fbwu|age|country}} |
{{flagg|unpe|country|avar=fbwu|age=age}} |
{{fbwu|17|China}} → China PR{{flagg|unpe|China|avar=fbwu|age=17}} → China PR
|
{{army|country}} |
{{flagg|unfe|country|avar=army}} (no automatic name override) |
{{army|China}} → People's Liberation Army Ground Force{{flagg|unfe|China|avar=army}} → China Army
|
{{navy|country}} |
{{flagg|unfe|country|avar=navy}} (no automatic name override) |
{{navy|China}} → People's Liberation Army Navy{{flagg|unfe|China|avar=navy}} → China Navy
|
{{air force|country}} |
{{flagg|unfe|country|avar=air force}} (no automatic name override) |
{{air force|China}} → People's Liberation Army Air Force{{flagg|unfe|China|avar=air force}} → China Air Force
|
See also[editar código]
- User:SiBr4/Flagg tests — extensive tests of the template's functions, which may also serve as additional examples
local p = {}
function p.main(frame)
--Get input arguments
local args = require('Module:Arguments').getArgs(frame,{valueFunc =
function(key,value)
if value then
value = mw.text.trim(value)
--Change empty string to nil for all args except 'image' and 'border'
if key=="image" or key=="border" or value~="" then
return value
end
end
return nil
end
})
--Call main function
return p.luaMain(frame,args)
end
function p.luaMain(frame,args)
local function emp2nil(x)
if x=="" then return nil else return x end
end
local function space2emp(x)
if string.find(x,"^%s*$") then return "" else return x end
end
local function nopx(x)
if x~=nil and (string.find(x,"^%d+$") or string.find(x,"^%d+px$")) then return string.gsub(x,"^(.*)px","%1") else return nil end
end
--Country & mode parameters
local mode = string.lower(args[1] or "usc")
local mi = string.sub(mode,1,1)
local ms = string.sub(mode,2,2)
local mn = string.sub(mode,3,3)
local me = string.sub(mode,4,-1)
local country = args[2] or ""
local avar = args["avar"] or args["altvar"]
local clink = args["clink"] or args["link"]
--Get country data & altvar data
local data, alink, amap, asuf
if avar then
local age = args["age"] or ""
local aalias
amap, aalias = require("Module:Flagg/Altvar data").alttable(age)
avar = string.gsub(string.lower(avar or ""),"[ \-]","")
avar = aalias[avar] or avar
if not amap[avar] then error("Unknown avar") end
local apar = {altvar=amap[avar].altvar;mw=amap[avar].mw;age=amap[avar].age;variant=args["variant"] or args[3]}
data = require("Module:CountryData").gettable(frame,country,apar)
asuf = amap[avar].altlink
alink = data["link alias-"..amap[avar].altvar] or (clink or data["shortname alias"] or data.alias or country).." "..asuf
else
data = (args["nodata"] and {}) or require("Module:CountryData").gettable(frame,country,{variant=args["variant"] or args[3]})
avar = ""
amap = {[""]={altvar=""}}
end
--Name and link parameters
clink = clink or data.alias or country
local pref = args["pref"]
local suff = args["suff"] or asuf
if not pref and not suff then --Default prefix
pref = "Flag of"
end
local yn_map = {[""]=0; ["0"]=0; ["no"]=0; ["n"]=0; ["1"]=1; ["yes"]=1; ["y"]=1}
local fthe = (args["pthe"] and yn_map[args["pthe"]]~=0) or (args["the"] and yn_map[args["the"]]~=0)
local nthe = (args["nthe"] and yn_map[args["nthe"]]~=0) or (args["the"] and yn_map[args["the"]]~=0)
fthe = fthe and (pref and "t" or "T").."he " or ""
nthe = nthe and (pref and "t" or "T").."he " or ""
local flink = args["plink"] or args["flink"] or alink
or clink=="" and "" or space2emp((pref or "").." ")..fthe..clink..space2emp(" "..(suff or ""))
local fsec = args["psection"] or args["section"]
local csec = args["csection"] or args["section"]
fsec = fsec and "#"..fsec or ""
csec = csec and "#"..csec or ""
if string.find(me,"f") then
if mw.title.new( flink ).exists == false then
flink = clink
end
end
local name = args["name"]
if not name then
local cname = string.find(me,"e") and (data["name alias-"..amap[avar].altvar] or data["shortname alias"] or data.alias) or country
if mn == "f" then
name = cname=="" and "" or space2emp((pref or "").." ")..nthe..cname..space2emp(" "..(suff or ""))
else
name = cname
end
end
--Image parameters
local pimage = args["image"]
local placeholder = "Flag placeholder.svg"
local variant = args["variant"] or args[3] or ""
local image_map = {[""]=placeholder; ["none"]=placeholder; ["blank"]=placeholder}
if pimage then --Remove namespace
pimage = string.gsub(pimage,"^[Ff][Ii][Ll][Ee]:","")
pimage = string.gsub(pimage,"^[Ii][Mm][Aa][Gg][Ee]:","")
end
local iname = image_map[pimage] or pimage
local size = args["size"] or args["sz"]
local size_map = {xs="12x8px"; s="17x11px"; m="23x15px"; l="32x21px"; xl="46x30px"}
if size==nil or string.find(size,"^%d*x?%d+px$") then
--valid EIS size (..px, x..px or ..x..px) or unset
elseif string.find(size,"^%d*x?%d+$") then --EIS size without "px" suffix
size=size.."px"
else --size from map, or invalid value
size = size_map[size] or nil
end
local border = args["border"]
if iname then
size = size or "23x15px"
if yn_map[border]==0 then border = "" else border = "|border" end
else
iname = data["flag alias-"..amap[avar].altvar.."-"..variant] or data["flag alias-"..variant] or data["flag alias-"..amap[avar].altvar] or data["flag alias"] or placeholder
size = size or emp2nil(data.size) or "23x15px"
if border then
if yn_map[border]==0 then border = "" else border = "|border" end
else
local autoborder = data["border-"..variant] or data["border-"..amap[avar].altvar] or data.border
if autoborder and autoborder~="border" then border = "" else border = "|border" end
end
end
local am = ""
if args["alt"] or string.find(me,"a") then
am = args["alt"] or args["name"] or country
am = am.."|"..am
end
--Build display name
local text = args["text"]
if not text then
if mn=="x" then --no text
text = ""
elseif mn=="p" or mn=="f" then --prefix/suffix link
text = flink=="" and name or "[["..flink..fsec.."|"..name.."]]"
elseif mn=="b" then --both prefix/suffix and normal country link
local preflink = pref and (flink=="" and pref.." " or "[["..flink..fsec.."|"..pref.."]] ") or ""
local sufflink = suff and (flink=="" and " "..suff or " [["..flink..fsec.."|"..suff.."]]") or ""
local namelink = (name=="" and "" or nthe)..(clink=="" and name or "[["..clink..csec.."|"..name.."]]")
text = preflink..namelink..sufflink
elseif mn=="d" then --data template
local title = mw.title.new("Template:Country data "..country)
--check if redirect
if title.isRedirect then
text = "<span class=\"plainlinks\">["..title:fullUrl("redirect=no").." "..name.."]</span>"
else
text = "[["..title.fullText.."|"..name.."]]"
end
elseif mn=="u" then --unlinked
text = name
else --country link (default)
text = clink=="" and name or "[["..clink..csec.."|"..name.."]]"
end
end
--Build image
local ilink = args["ilink"]
if not ilink then
if mi=="x" or (iname==placeholder and pimage~=placeholder) then --no image/invisible image
iname = placeholder
border = ""
ilink = "|link="
am = ""
elseif mi=="i" then --image page link
ilink = ""
elseif mi=="c" then --country link
ilink = "|link="..clink..(clink=="" and "" or csec)
elseif mi=="p" or mi=="f" then --prefix/suffix link
ilink = "|link="..flink..(flink=="" and "" or fsec)
elseif mi=="d" then --data template
local title = mw.title.new("Template:Country data "..country)
--check if redirect
if title.isRedirect then
ilink = "|link="..title:fullUrl("redirect=no")
else
ilink = "|link="..title.fullText
end
else --unlinked (default)
ilink = "|link="
end
end
if am == "" and string.find(me,"l") then
am = mw.ustring.sub(ilink,7,-1)
end
local image = "[[File:"..iname.."|"..size..border..ilink.."|alt="..am.."]]"
if iname==placeholder then
if require('Module:yesno')(args["noredlink"]) == false then
iname = ''
image = "[[:Template:Country data "..country.."]]"
end
if (args["missingcategory"] or '') ~= '' then
image = image..args["missingcategory"]
end
if string.find(me,"b") then
text = ''
end
end
--Combine image and name with separator
local align = args["align"] or args["al"]
local nalign = args["nalign"] or args["nal"]
local align_map = {left="left", l="left", center="center", centre="center", c="center", middle="center", m="center", right="right", r="right"}
local out
if string.find(me,"r") then
--image right of name
if (ms=="x" and mi=="x") or (string.find(me,"o") and iname==placeholder and pimage~=placeholder) then --name only
out = text
elseif ms=="x" then --no separator
out = text.."<span class=\"flagicon\">"..image.."</span>"
elseif ms=="n" then --non-breaking space
out = text.."<span class=\"flagicon\"> "..image.."</span>"
elseif ms=="l" then --line break
out = text.."<span class=\"flagicon\"><br/>"..image.."</span>"
elseif ms=="t" then --table cell
out = "style=\"text-align:"..(align_map[nalign] or "left").."\"|"..text.."||style=\"text-align:"..(align_map[align] or "center")..";\"|<span class=\"flagicon\">"..image.."</span>"
else --fixed-width span box (default)
local width = args["width"] or args["w"] or require("Module:Flaglist").luawidth(size)
out = text.." <span class=\"flagicon\" style=\"display:inline-block;width:"..width.."px;text-align:"..(align_map[align] or "right")..";\">"..image.."</span>"
end
else --image left of name
if (ms=="x" and mi=="x") or (string.find(me,"o") and iname==placeholder and pimage~=placeholder) then --name only
out = text
elseif ms=="x" then --no separator
out = "<span class=\"flagicon\">"..image.."</span>"..text
elseif ms=="n" then --non-breaking space
out = "<span class=\"flagicon\">"..image.." </span>"..text
elseif ms=="l" then --line break
out = "<span class=\"flagicon\">"..image.."<br/></span>"..text
elseif ms=="t" then --table cell
out = "style=\"text-align:"..(align_map[align] or "center")..";\"|<span class=\"flagicon\">"..image.."</span>||style=\"text-align:"..(align_map[nalign] or "left").."\"|"..text
else --fixed-width span box (default)
local width = nopx(args["width"] or args["w"]) or require("Module:Flaglist").luawidth(size)
out = "<span class=\"flagicon\" style=\"display:inline-block;width:"..width.."px;text-align:"..(align_map[align] or "left")..";\">"..image.."</span> "..text
end
end
if string.find(me,"w") then --avoid wrapping
out = "<span class=\"nowrap\">"..out.."</span>"
end
--Tracking categories
local cat = ""
if pimage and not image_map[pimage] and country~="" and data["flag alias"] and not args.demo then
cat = "[[Category:Pages using Flagg with specified image instead of data template image]]"
end
return out..cat
end
return p