This module provides access to Module:languages from templates, so that they can make use of the information stored there.
If you know a language's code (for example, "en") and you want to find out its canonical name, you can use this:
{{#invoke:languages/templates|getByCode|en|getCanonicalName}} (returns "English")If you know a language's canonical name (for example, "English") and you want to find out its code, use this:
{{#invoke:languages/templates|getByCanonicalName|English|getCode}} (returns "en")Both of these functions are subst:able (type {{subst:#invoke:...).
{{#invoke:languages/templates|exists|language code}}
Check whether a language code exists and is valid. It will return "1" if the language code exists, and the empty string "" if it does not.
This is rarely needed, because a script error will result when someone uses a code that is not valid, so you do not need this just to check for errors. However, in case you need to decide different actions based on whether a certain parameter is a language code or something else, this function can be useful.
{{#invoke:languages/templates|getByCode|language code|item to look up|index}}
Queries information about a language code.
getCanonicalName or getScripts. If no item has been provided, the result will be a script error.getOtherNames or getScripts. It selects which item in the list to return. On items that are single strings, like getFamily, it has no effect. If an index is given that is higher than the number of items in the list, the result will be an empty string.For example, to request the canonical name of the language whose code is en:
{{#invoke:languages/templates|getByCode|en|getCanonicalName}}
angolTo request its second name, if any:
{{#invoke:languages/templates|getByCode|en|getOtherNames|1}}
modern englishTo request its family:
{{#invoke:languages/templates|getByCode|en|getFamily}}
gmw{{#invoke:languages/templates|getByCanonicalName|language name}}
Gets the language code corresponding to a canonical name.
{{#invoke:languages/templates|getByCanonicalName|angol}}{{#invoke:languages/templates|getByName|language name}}
Like the above, except it will also accept other names for the language that are listed in the language's otherNames field. For instance:
{{#invoke:languages/templates|getByName|Modern English}}{{#invoke:languages/templates|getCanonicalName|language code}}
Gets the canonical name for a language code if the language code is valid, or else returns an empty string. It uses a table that converts language code to canonical name, generated by Module:languages/code to canonical name. Requires more Lua memory than getByCode (about 10 megabytes) for a single instance, but may require less memory on pages that call the function many times.
Unlike {{#invoke:languages/templates|getByCode|<language_code>|getCanonicalName}}, this function does does not yield a script error for an invalid language code.
{{#invoke:languages/templates|getCanonicalName|en}}{{#invoke:languages/templates|getCanonicalName|invalid code}}angollocal export = {}
function export.exists(frame)
local args = frame.args
local lang = args or error("Language code has not been specified. Please pass parameter 1 to the module invocation.")
lang = require("Module:languages").getByCode(lang)
if lang then
return "1"
else
return ""
end
end
-- Used by the following JS:
-- * ]
-- * ]
-- * ]
function export.getByCode(frame)
local iparams = {
= {required = true},
= {required = true},
= {},
= {},
= {},
}
local iargs = require("Module:parameters").process(frame.args, iparams)
local langcode = iargs
local lang = require("Module:languages").getByCode(langcode, true)
return require("Module:language-like").templateGetByCode(lang, iargs,
function(itemname)
local list
if itemname == "getWikimediaLanguages" then
list = lang:getWikimediaLanguages()
elseif itemname == "getScripts" then
list = lang:getScriptCodes()
elseif itemname == "getAncestors" then
list = lang:getAncestors()
end
if list then
local index = iargs
index = tonumber(index) or error("Please specify the numeric index of the desired item.")
local retval = list
if retval then
if type(retval) == "string" then
return retval
else
return retval:getCode()
end
else
return ""
end
end
if itemname == "transliterate" then
local text = iargs
local sc = iargs
local module_override = iargs
sc = sc and require("Module:scripts").getByCode(sc, 4) or nil
return lang:transliterate(text, sc, module_override) or ""
elseif itemname == "makeEntryName" then
local text = iargs
return lang:makeEntryName(text) or ""
elseif itemname == "makeSortKey" then
local text = iargs
return lang:makeSortKey(text) or ""
elseif itemname == "countCharacters" then
local text = args or ""
local sc = require("Module:scripts").getByCode(iargs, 4)
return sc:countCharacters(text)
end
end
)
end
function export.getByCanonicalName(frame)
local args = frame.args
local langname = args or error("Language name has not been specified. Please pass parameter 1 to the module invocation.")
local lang = require("Module:languages").getByCanonicalName(langname)
if lang then
return lang:getCode()
else
return ""
end
end
function export.getByName(frame)
local args = frame.args
local langname = args or error("Language name has not been specified. Please pass parameter 1 to the module invocation.")
local lang = require("Module:languages").getByName(langname)
if lang then
return lang:getCode()
else
return ""
end
end
function export.makeEntryName(frame)
local args = frame.args
local langname = args or error("Language name has not been specified. Please pass parameter 1 to the module invocation.")
local lang = require("Module:languages").getByCode(langname)
if lang then
return lang:makeEntryName(args)
else
return ""
end
end
function export.getCanonicalName(frame)
local langCode, args
if require("Module:yesno")(frame.args.parent) then
args = frame:getParent().args
else
args = frame.args
end
langCode = args
if not langCode or langCode == "" then
error("Supply a language code in parameter 1.")
end
return mw.loadData("Module:languages/code to canonical name")
or not args.return_if_invalid and "" or langCode
end
return export