Kontent qismiga oʻtish

Modul:Flagg

Vikipediya, ochiq ensiklopediya

{{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.

Aliases (alternatives) for each parameter or value are given in square brackets.

Format (first unnamed parameter)

[manbasini tahrirlash]

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 i, i** or izz will be read as isc.

First letter: Image

Letter Meaning Description Example
u unlinked Image is not linked (default). {{flagg|uxx|France}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheA' not found.
c country Image links to country/entity page. {{flagg|cxx|France}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheA' not found.
p [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}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheA' not found.
i image page Image links to file description page; use this for non-public-domain images, for which attribution is required. {{flagg|ixx|France}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheA' not found.
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}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheA' not found.
x X mark No image is displayed. If the second letter is anything other than x, and o is not set, an unlinked transparent image is actually used to preserve the spacing. {{flagg|xnx|France}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheA' not found.

Second letter: Separator

Letter Meaning Description Example
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
n non-breaking space A non-breaking space (&nbsp;) is used, like in most flag templates, including {{flag}}. Note that &nbsp; does not actually prevent wrapping between image and text in all browsers; use w as described below if needed. {{flagg|unu|Niger}} Niger
l line break A line break (<br/>) is used as separator. {{flagg|ulu|Niger}}
Niger
t table cell A table cell separator (two pipes) is used. Niger
x X mark No separator is used. {{flagg|uxu|Niger}}Niger

Third letter: Name

Letter Meaning Description Example
c country The country name links to the main country/entity page (default). {{flagg|xxc|Chile}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheD' not found.
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}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheD' not found.
f full prefix/suffix Same as p, except that the prefix and/or suffix is/are displayed. {{flagg|xxf|Chile}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheD' not found.
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}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheD' not found.
u unlinked (cf. {{flagu}}) The country name is displayed as plain text, without link. {{flagg|xxu|Chile}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheD' not found.
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}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheD' not found.
x X mark No text is displayed. {{flagg|xxx|Chile}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheD' not found.
* Add * Similar to "p", except that an asterisk (*) is added to the text of the link if it goes to a more specific article. {{flagg|xx*|Chile}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheD' not found.

Some additional options can be enabled by appending the following letters to the three-letter code in any order:

Letter Description Example
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}}Pakistan
b Blanks the text portion if a flag is not found. {{flagg|uncb|Xanadu}} 
Compare with:
{{flagg|unc|Xanadu}} Xanadu
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}} Pokiston
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}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheE' not found.
Compare with:
{{flagg|psf|Egypt|pref=Flag templates in}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheE' not found.
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}}Pokiston
Compare with:
{{flagg|cxxa|PAK}}PAK
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=}} → Pakistan
Compare with:
{{flagg|unu|Pakistan|image=}} Pakistan
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 
w Avoids wrapping by adding <span class="nowrap">...</span> around the output. {{flagg|unuw|Pakistan}} Pakistan
t Aligns to the left in a table.

Entity (second unnamed parameter)

[manbasini tahrirlash]

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 e option above is not used.

Image parameters

[manbasini tahrirlash]
|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 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 (s) and table cell (t) formats. For t, the default is center; for s, it is right-aligned if r is set, else left-aligned.
|width= [|w=]
Sets the width of the span box surrounding the image for the span box (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 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.
[manbasini tahrirlash]
|name=
Changes the displayed country name. Note that with the 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 f, p and b options.
|pref=, |suff=, |plink=
|pref= and |suff= set the prefix and suffix to use for the prefix/suffix links (format letters f, p and 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}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheE' not found.. 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}}Lua xatosi in package.lua at line 80: module 'Module:Flagg/Altvar data' not found. 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 (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 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.
|pref2=, |suff2=, |plink2=, |psection2=
If the f extra is specified, and the prefix/suffixed article name being linked to doesn't exist, then use these parameters as an alternate prefix/suffix, and check if it exists as well. (If it still doesn't exist, then fall back to the non-prefixed/suffixed page as normal). This may be expensive, and the number of time it can be used on single page is limited.

Formats:

  • {{flagg|usc|Fiji}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheK' not found. (default format)
  • {{flagg||Fiji}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheK' not found. (default format)
  • {{flagg|pnbr|Fiji}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheK' not found.
  • <span style="display:inline-block;text-align:center;">{{flagg|ilf|Fiji|sz=xl}}</span>Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheK' not found.

Table format & alignment:

{{flagg|utu|Jamaica}} Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheG' not found.
{{flagg|utur|Jamaica}} Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheG' not found.
{{flagg|utu|Jamaica|al=l|nal=l}} Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheG' not found.
{{flagg|utu|Jamaica|al=c|nal=c}} Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheG' not found.
{{flagg|utu|Jamaica|al=r|nal=r}} Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheG' not found.
  • {{flagg|usu|Switzerland}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheB' not found.
  • {{flagg|usu|Switzerland|al=l}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheB' not found.
  • {{flagg|usu|Switzerland|al=c}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheB' not found.
  • {{flagg|usu|Switzerland|al=r}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheB' not found.

Standard image & name parameters:

  • {{flagg|isc|Myanmar}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheJ' not found.
  • {{flagg|isc|Myanmar|border=}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheJ' not found.
  • {{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}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheJ' not found.
  • {{flagg|isc|Myanmar|size=30}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheJ' not found.
  • {{flagg|isc|Myanmar|size=30px}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheJ' not found.
  • {{flagg|isc|Myanmar|size=30x18px}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheJ' not found.
  • {{flagg|isc|Myanmar|size=xs}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheJ' not found.
  • {{flagg|isc|Myanmar|size=xl}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheJ' not found.
  • {{flagg|isc|Myanmar|width=30|size=xs}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheJ' not found.
  • {{flagg|isc|Myanmar|image=}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheJ' not found.
  • {{flagg|isc|Myanmar|image=Flag of None.svg}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheJ' not found.
  • {{flagg|isc|Myanmar|image=File:Flag of None.svg}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheJ' not found.

Links and altvars:

  • {{flagg|psp|Egypt}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheE' not found.
  • {{flagg|psf|Egypt}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheE' not found.
  • {{flagg|psb|Egypt}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheE' not found.
  • {{flagg|psb|Philippines|the=1}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheE' not found.
  • {{flagg|csc|Egypt|section=History}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheE' not found.
  • {{flagg|csb|Egypt|csection=History}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheE' not found.
  • {{flagg|psb|Egypt|psection=Kingdom of Egypt (1922–1953)|variant=1922}} Flag of Egypt
  • {{flagg|psb|Egypt|plink=List of Egyptian flags}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheE' not found.
  • {{flagg|psf|Egypt|pref=History of}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheE' not found.
  • {{flagg|psp|Egypt|suff=at the Olympics}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheE' not found.
  • {{flagg|psp|Egypt|avar=fb}}Lua xatosi in package.lua at line 80: module 'Module:Flagg/Altvar data' not found.
  • {{flagg|psp|Egypt|avar=football}}Lua xatosi in package.lua at line 80: module 'Module:Flagg/Altvar data' not found.
  • {{flagg|psp|Egypt|avar=fbu|age=20}}Lua xatosi in package.lua at line 80: module 'Module:Flagg/Altvar data' not found.
  • {{flagg|psf|Egypt|avar=navy}}Lua xatosi in package.lua at line 80: module 'Module:Flagg/Altvar data' not found.

Non-existing data template:

  • {{flagg|isc|EUSSR|nodata=1}} EUSSR
  • {{flagg|isc|EUSSR|image=EUSSR red flag.svg|size=xl|nodata=1}} EUSSR
[manbasini tahrirlash]
See also: Help:Table#Adding links to specialized country, state, or territory articles.

For example:

Once you have a table with {{flaglist}} or other flag template it is easy to convert the links to specialized links. So instead of Oklahoma you would have Incarceration in Oklahoma, or if that article does not exist, then Crime in Oklahoma.

Use a global find-and-replace in the wikitext. Replace:

{{flaglist

with

{{flagg|us*eft|pref=Incarceration in|pref2=Crime in

The {{flagg}} template looks for the articles. If it finds one of the two choices it adds the link and an asterisk after the state, country, territory, or other subnational area name. If it does not find either article, it just adds the standard link.

Substitute your preferred topics in the pref= and pref2= spots. For more info see Help:Table and its sections on adding flags and country/state/territory links.

This particular use of {{flagg}} parameters is expensive and can only be used on a few hundred links per article. Every time the article is saved it occurs. So only one big country table per article. Other country tables in the same article should use standard links.

Comparison with other templates

[manbasini tahrirlash]

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

[manbasini tahrirlash]
Template Corresponding {{flagg}} syntax Example
{{flag|country}} {{flagg|uncb|country}} {{flag|China}} China
{{flagg|unc|China}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheB' not found.
{{flagbig|country}} {{flagg|ulc|country|sz=l}} {{flagbig|China}}Andoza:Flagbig
{{flagg|ulc|China|sz=l}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheB' not found.
{{flagc|country}} {{flagg|inc|country}} {{flagc|China}}Andoza:Flagc
{{flagg|inc|China}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheB' not found.
{{flagcountry|country}} {{flagg|unce|country}} {{flagcountry|CHN}} Xitoy
{{flagg|unce|CHN}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheB' not found.
{{flagdeco|country}} {{flagg|uxxo|country}} {{flagdeco|China}}
{{flagg|uxx|China}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheB' not found.
{{flagicon|country}} {{flagg|cxxlo|country}} {{flagicon|China}}Xitoy
{{flagg|cxxlo|China}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheB' not found.
{{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}} Xitoy
{{flagg|unp|China|suff=at the Hopman Cup}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheB' not found.
{{flag+link|prefix|country}} {{flagg|unp|country|pref=prefix}} (no existence check) {{flag+link|Agriculture in|China}}Andoza:Flag+link
{{flagg|unp|China|pref=Agriculture in}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheB' not found.
{{flaglist|country}} {{flagg|usc|country}} {{flaglist|China}} China
{{flagg|usc|China}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheB' not found.
{{flagof|country}} {{flagg|unp|country|sz=l}} {{flagof|China}}Andoza:Flagof
{{flagg|unp|China|sz=l}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheB' not found.
{{flagright|country}} {{flagg|uncr|country}} {{flagright|China}}Andoza:Flagright
{{flagg|uncr|China}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheB' not found.
{{flagu|country}} {{flagg|unu|country}} {{flagu|China}} China
{{flagg|unu|China}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheB' not found.
{{noflag|country}} {{flagg|xnu|country}} {{noflag|China}} China
{{flagg|xnu|China}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheB' not found.
{{noflag|[[country]]}} {{flagg|xnc|country}} {{noflag|[[China]]}} China
{{flagg|xnc|China}}Lua xatosi in package.lua at line 80: module 'Module:CountryData/cacheB' not found.

Sports/military templates

[manbasini tahrirlash]

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}} Xitoy
{{flagg|unpe|China|avar=fb}}Lua xatosi in package.lua at line 80: module 'Module:Flagg/Altvar data' not found.
{{fb|country|align=1}} {{flagg|uspe|country|avar=fb|al=c}} {{fb|China|align=1}}Andoza:Flaglink/aligned
{{flagg|uspe|China|avar=fb|al=c}}Lua xatosi in package.lua at line 80: module 'Module:Flagg/Altvar data' not found.
{{fb-big|country}} {{flagg|ulpe|country|avar=fb|sz=l}} {{fb-big|China}}
Xitoy
{{flagg|ulpe|China|avar=fb|sz=l}}Lua xatosi in package.lua at line 80: module 'Module:Flagg/Altvar data' not found.
{{fb-rt|country}} {{flagg|unpre|country|avar=fb}} {{fb-rt|China}}Xitoy 
{{flagg|unpre|China|avar=fb}}Lua xatosi in package.lua at line 80: module 'Module:Flagg/Altvar data' not found.
{{fbu|age|country}} {{flagg|unpe|country|avar=fbu|age=age}} {{fbu|17|China}} Xitoy
{{flagg|unpe|China|avar=fbu|age=17}}Lua xatosi in package.lua at line 80: module 'Module:Flagg/Altvar data' not found.
{{fbw|country}} {{flagg|unpe|country|avar=fbw}} {{fbw|China}} Xitoy
{{flagg|unpe|China|avar=fbw}}Lua xatosi in package.lua at line 80: module 'Module:Flagg/Altvar data' not found.
{{fbwu|age|country}} {{flagg|unpe|country|avar=fbwu|age=age}} {{fbwu|17|China}} Xitoy
{{flagg|unpe|China|avar=fbwu|age=17}}Lua xatosi in package.lua at line 80: module 'Module:Flagg/Altvar data' not found.
{{army|country}} {{flagg|unfe|country|avar=army}} (no automatic name override) {{army|China}}Andoza:Army
{{flagg|unfe|China|avar=army}}Lua xatosi in package.lua at line 80: module 'Module:Flagg/Altvar data' not found.
{{navy|country}} {{flagg|unfe|country|avar=navy}} (no automatic name override) {{navy|China}} Xalq Harbiy dengiz kuchlarining Ozod Armiyasi
{{flagg|unfe|China|avar=navy}}Lua xatosi in package.lua at line 80: module 'Module:Flagg/Altvar data' not found.
{{air force|country}} {{flagg|unfe|country|avar=air force}} (no automatic name override) {{air force|China}} Xalq Havo kuchlarining Ozod Armiyasi
{{flagg|unfe|China|avar=air force}}Lua xatosi in package.lua at line 80: module 'Module:Flagg/Altvar data' not found.
  • User:SiBr4/Flagg tests — extensive tests of the template's functions, which may also serve as additional examples

local titleSelf = mw.title.new(... or mw.getCurrentFrame():getTitle())
local titleCountryData = mw.title.new[[Module:CountryData]]
if titleSelf.isSubpage then
	local sandbox = titleSelf.subpageText:match[[^sandbox]]
	if sandbox then
		titleCountryData = titleCountryData:subPageTitle(sandbox)
	end
end
local CountryData = require(tostring(titleCountryData))
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 countryDataCountry = country
	if string.find(me, "i") then
	    local titleIocCountryData = mw.title.new[[Module:Country alias/data]]
	    local IocCountryData = require(tostring(titleIocCountryData))
	    local iocCountryAlias = IocCountryData.countryAliases[country] or country
	    countryDataCountry = IocCountryData.countries[iocCountryAlias]["countrydata_name"] or IocCountryData.countries[iocCountryAlias]["name"]
	end
	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 = CountryData.getcachedtable(frame, countryDataCountry, 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 CountryData.getcachedtable(frame, countryDataCountry, {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
	local pref2 = args["pref2"]
	local suff2 = args["suff2"]
	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 flink2
	if args["plink2"] or args["flink2"] or pref2 or suff2 then
		flink2 = args["plink2"] or args["flink2"] or clink=="" and "" or space2emp((pref2 or "").." ")..fthe..clink..space2emp(" "..(suff2 or ""))
	else
		flink2 = flink
	end
	local fsec = args["psection"] or args["section"]
	local fsec2 = args["psection2"] or args["section"]
	local csec = args["csection"] or args["section"]
	fsec = fsec and "#"..fsec or ""
	fsec2 = fsec2 and "#"..fsec2 or ""
	csec = csec and "#"..csec or ""

	if string.find(me,"f") then
		if mw.title.new( flink ).exists == false then
			if flink2 ~= flink and mw.title.new ( flink2 ).exists == true then
				flink = flink2
				fsec = fsec2
			else
				flink = clink
			end
		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" or mn == "*" then --prefix/suffix link
			text = flink=="" and name or "[["..flink..fsec.."|"..name.."]]"
			-- By the principle of least surprise, there should be some
			-- indication that the link [[X of Country|Country]] does not
			-- go to [[Country]].
			if mn == "*" and clink ~= flink then
				text = text:sub(1, -3) .. "\226\128\175*]]" end
		elseif mn=="l" then --display link target
			text = flink=="" and name or "[["..flink..fsec.."|"..(args["name"] or flink).."]]"
		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
		elseif mn=="a" then --abbr
			text = name==country and (clink==country and country or "<abbr title='"..clink.."'>"..country.."</abbr>") or ("<abbr title='"..name.."'>"..country.."</abbr>")
		else --country link (default)
			text = clink=="" and name or "[["..clink..csec.."|"..name.."]]"
		end
		if string.find(me,"p") then
			text = "("..text..")"
		end
	end
	
	if type(text) == 'function' then
		text = text(data)
	end

	--Define separator
	local separator = "&nbsp;" --non-breaking space (n)
	if ms=="x" then --no separator
		separator = ""
	elseif ms=="l" then --line break
		separator = "<br />"
	end
	
	--Add preftext, if used
	local preftext = args["preftext"]
	if (preftext or "") ~= "" then
		text = preftext..separator..text
	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 or args["noredlink"] == "notext" then
			if country ~= '' and data.alias == nil then
				iname = ''
				image = "[[:Template:Country data "..country.."]]"
				if args["noredlink"] == "notext" then
					text = ''
				end
			end
		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_map = {left="left", l="left", center="center", centre="center", c="center", middle="center", m="center", right="right", r="right"}
	local align = align_map[args["align"] or args["al"]]
	local nalign =  align_map[args["nalign"] or args["nal"]]
	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" or ms=="n" or ms=="l" then --no separator, non-breaking space, or line break
			out = text.."<span class=\"flagicon\">"..separator..image.."</span>"
		elseif ms=="t" then --table cell
			out = "style=\"text-align:"..(nalign or "left").."\"|"..text.."||style=\"text-align:"..(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.."&nbsp;<span class=\"flagicon\" style=\"display:inline-block;width:"..width.."px;text-align:"..(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" or ms=="n" or ms=="l" then --no separator, non-breaking space, or line break
			out = "<span class=\"flagicon\">"..image..separator.."</span>"..text
		elseif ms=="t" then --table cell
			out = "style=\"text-align:"..(align or "center")..";\"|<span class=\"flagicon\">"..image.."</span>||style=\"text-align:"..(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 or "left").."\">"..image.."</span>&nbsp;"..text
		end
	end
	if string.find(me,"w") then --avoid wrapping
		out = "<span class=\"nowrap\">"..out.."</span>"
	end
	
	-- align in table
	if me:find("t") then
		out = 'style="text-align:'..(align or 'left')..'"|'..out
	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

p[''] = p.main

return p