模板:Country alias/doc

此页面是Template:Country alias的模板文档。
此页面可能包含了模板的使用说明、分类和其他内容。

此模板使用Lua语言：

Module:Country alias（沙盒）

本模板根据所输入的数据返回对应的国家和地区名称或旗帜。

{{Country alias}}主要用于奥林匹克运动会、残疾人奥林匹克运动会、英联邦运动会、亚洲运动会等综合体育赛事。

用法

本模板包含以下参数，其中第一个参数为必输参数：

country/1: 由三个字母（少数为四个字母）组成的国家和地区代码。该参数可以为非命名参数。关于各国家和地区所使用的缩写，请参阅国际奥委会国家编码列表条目
flag: 如果设定为yes，将返回国家和地区旗帜文件名，否则返回国家和地区名
year: 主要用于决定具体返回的国家和地区名或旗帜的参数之一。例如country参数输入TUN，year参数输入1998年，会返回的旗帜是“Pre-1999 Flag of Tunisia.svg”，输入2000年，会返回的旗帜是“Flag of Tunisia.svg”。
games: 主要用于决定具体返回的国家和地区名或旗帜的参数之一。例如1980年夏季奥林匹克运动会有相当一部分国家和地区选择以奥林匹克旗帜参赛。注意调用本模板时确保该参数非繁简混用。
lan: 主要用于决定返回的国家和地区名的中文用字。例如输入country参数输入KEN，lan参数输入zh-tw，则返回的国家和地区名为“肯亞”，目前调用时输入的值为“zh-cn”。

范例

以下以意大利（ITA）为例展示各种组合的输入所返回的结果

ITA = {
	name = "Italy",
	{1946, "Flag of Italy (1861-1946).svg"},
	{2002, "Flag of Italy.svg"},
	{2006, "Flag of Italy (2003-2006).svg"},
	"Flag of Italy.svg",
	["夏季奥林匹克运动会"] = {
		[1980] = "Olympic flag.svg",
	},
	["夏季奧林匹克運動會"] = {
		[1980] = "Olympic flag.svg",
	},
}

{{Country alias|ITA}} → 意大利
{{Country alias|ITA|flag=yes}} → Flag of Italy.svg
{{Country alias|ITA|flag=yes|year=1946}} → Flag of Italy (1861-1946).svg
{{Country alias|ITA|flag=yes|year=1947}} → Flag of Italy.svg
{{Country alias|ITA|flag=yes|year=1980|games=夏季奥林匹克运动会}} → Olympic flag.svg
{{Country alias|ITA|flag=yes|year=2006|games=夏季奥林匹克运动会}} → Flag of Italy (2003–2006).svg

注意上述最后一个示例中，games参数并未影响到最终返回的旗帜文件名。

错误示例

如果所输入的代码是模块中所不支持的，调用模板时会返回错误信息：

{{Country alias}} → Lua错误在Module:Country_alias的第275行：Invalid country alias: {{{country}}}
{{Country alias|}} → Lua错误在Module:Country_alias的第275行：Invalid country alias: nil
{{Country alias|EXZ}} → Lua错误在Module:Country_alias的第275行：Invalid country alias: EXZ
{{Country alias|country=EXZ}} → Lua错误在Module:Country_alias的第275行：Invalid country alias: EXZ

调用模板时也可使用|error=value来自定义所返回的错误信息：

{{Country alias|EXZ|error=ERROR}} → ERROR