Module:UnitPlural

Module documentation[view] [edit] [history] [purge]

Function main

The main function takes a number and unit name (|quantity=) and an optional language code (|lang=) from the frame.

It returns the quantity with proper plural units in the given language, if it can.

It will find use when the quantity is returned from Wikidata, so that the numerical value is not yet known.

Examples

• {{#invoke:UnitPlural |main |quantity=1 week}} →
• {{#invoke:UnitPlural |main |quantity=3 week}} →
• {{#invoke:UnitPlural |main |quantity=3.50 week}} →
• {{#invoke:UnitPlural |main |quantity=1 foot}} →
• {{#invoke:UnitPlural |main |quantity=3 foot}} →
• {{#invoke:UnitPlural |main |quantity=1 mile per hour}} →
• {{#invoke:UnitPlural |main |quantity=3 mile per hour}} →
• {{#invoke:UnitPlural |main |quantity=1 standard gravity}} →
• {{#invoke:UnitPlural |main |quantity=3 standard gravity}} →
• {{#invoke:UnitPlural |main |quantity=1 foot}} →
• {{#invoke:UnitPlural |main |quantity=3 solar mass}} →

Function plural

Function plural is equivalent to function main(frame), but takes parameters for use in other modules. The langcode is optional and is "en" by default on enwiki.

• quant = plural(quant, langcode)

Function pl

Function pl returns the plural of the unit name, and takes parameters for use in other modules. The langcode is optional and is "en" by default on enwiki.

• unitnameplural = pl(unitname, langcode)

The above documentation is transcluded from Module:UnitPlural/doc. (edit | history)
Editors can experiment in this module's sandbox (create | mirror) and testcases (create) pages.
Subpages of this module.

-- Module to create plurals for units (initially)
-- Might be split into code and data

--[[
Plurals by language
--]]
local plural = {
	-- English
	en = {
		["inch"] = "inches",
		["foot"] = "feet",
		["square foot"] = "square feet",
		["cubic foot"] = "cubic feet",
		["pound-force"] = "pounds-force",
		["kilogram-force"] = "kilograms-force",
		["horsepower"] = "horsepower",
		["gauss"] = "gauss",
		["solar mass"] = "solar masses",
		["hertz"] = "hertz",
		["degree Fahrenheit"] = "degrees Fahrenheit",
		["degree Celsius"] = "degrees Celsius",
		["standard gravity"] = "standard gravities",
	},
}

--[[
findLang takes a "langcode" parameter if if supplied and valid.
Otherwise it tries to create it from the user's set language ({{int:lang}})
Failing that, it uses the wiki's content language.
It returns a language object.
--]]
local function findLang(langcode)
	local langobj
	langcode = mw.text.trim(langcode or "")
	if mw.language.isKnownLanguageTag(langcode) then
		langobj = mw.language.new( langcode )
	else
		langcode = mw.getCurrentFrame():preprocess( '{{int:lang}}' )
		if mw.language.isKnownLanguageTag(langcode) then
			langobj = mw.language.new( langcode )
		else
			langobj = mw.language.getContentLanguage()
		end
	end
	return langobj
end

--[[
pl takes a unit name and an optional language code
It returns the plural of that unit in the given language, if it can.
--]]
local function pl(unit, langcode)
	langcode = findLang(langcode).code
	unit = tostring(unit) or ""
	if plural.langcode then
		return "Debug: pass"
	else
		return "Debug: fail"
	end
end

local p = {}

--[[
p.pl takes a unit name and an optional language code from the frame or its parent.
It returns the plural of that unit in the given language, if it can.
--]]
function p.pl(frame)
	if frame.args.unit then
		args = frame.args
	else
		args = frame:getParent().args
	end
	if not args.unit then return "Debug: Nothing supplied" end

	return pl(args.unit, args.lang)
end

return p