Module:UnitPlural: Difference between revisions

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 = {
		-- standard suffix, and "per":
		"s",
		["per"] = "per",
		-- irregular plurals:
		["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 ""
	local ret = ""
	if plural[langcode] then
		if plural[langcode][unit] then
			-- irregular plural from lookup
			ret = plural[langcode][unit]
		else
			local per = plural[langcode].per
			local u1, u2 = unit:match("(.+) " .. per .. " (.+)")
			if u1 then
				-- recurse to give plural of bit before " per "
				ret = pl(u1) .. " per " .. u2
			else
				-- standard plural
				ret = unit .. plural[langcode][1]
			end
		end
	else
		-- unknown language, so return unchanged
		ret = unit
	end
	return ret
end

local p = {}

--[[
p.main 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.main(frame)
	if frame.args.unit then
		args = frame.args
	else
		args = frame:getParent().args
	end
	-- if nothing supplied, return nothing (or an error message if debugging)
	if not args.unit then return "" end

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

return p