Module:Sharpness documentation

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

This module should not be invoked directly; use its corresponding template instead: Template:Sharpness documentation.

This module is used for Template:Sharpness documentation to automate information for sharpness templates (templates that show how many steps sharps or flats raise or lower by).

By default, it handles standard sharps and flats, quarter-tone accidentals, and ups and downs notation.

Introspection summary for Module:Sharpness documentation

Functions provided (1)
Line	Function	Params
3	`main` (invokable)	`(frame)`

Lua modules required (0)
Variable	Module	Functions used

No function descriptions were provided. The Lua code may have further information.

local p = {}

function p.main(frame)
	local in_str = frame.args["input"]
	local d, b, c = in_str:match("%-(%a*)(%d+)(%a*)")
	local s = tonumber(b)
	local sc = s * 12
	local note = frame.args["note"] or ""
	local notation = frame.args["notation"] or ""
	
	if c == nil then
		c = ""
	end
	
	local out_str = "This template is used "
	
	if (d == "flat" or d == "flat") then
		s = -s
	end
	
	if s == 0 then
		out_str = out_str
			.. "for {{EDOs| 7, 14, 21, 28, and 35 }} [[equal divisions of the octave]]. "
			.. "Since these tunings temper out the 3-limit augmented unison ([[2187/2048]], known as the Pythagorean apotome), "
			.. "going up seven fifths brings one back to the root note, and as such, "
			.. "the traditional sharps and flats are redundant and cannot raise or lower the pitch."
	else
		out_str = out_str
			.. "for [[EDO]]s where a sharp "
			.. ((s < 0) and {"lowers"} or {"raises"})[1] .. " by " .. math.abs(s) .. " step"
			
		if math.abs(s) ~= 1 then
			out_str = out_str .. "s"
		end
		
		out_str = out_str .. "."
		
		if notation == "" then
			out_str = out_str .. " This symbol set "
			
			if s == 2 then
				out_str = out_str .. "comprises sharps, flats, and Stein&ndash;Zimmerman [[24edo#Notation|quarter tone]] accidentals."
			elseif s >= 3 then
				if c == "" then
					out_str = out_str .. "[[ups and downs notation]] and comprises sharps, flats, "
					.. (s % 2 == 0
						and "naturals, and Stein&ndash;Zimmerman [[24edo#Notation|quarter tone]] accidentals "
						or "and naturals ")
					
					out_str = out_str .. "with arrows from [[Helmholtz&ndash;Ellis notation]]."
				elseif c == "a" or c == "A" then
					out_str = out_str .. "is based on [[ups and downs notation]] using separate arrows."
				end
			end
		else
			out_str = out_str .. " It is based on " .. notation .. "."
		end
		
		if note then
			out_str = out_str .. " " .. note
		end
		
		if s >= 1 then
			out_str = out_str
				.. "\n\n<h3>Parameters</h3>\n"
				.. "Passing <code>{{pipe}}"
				.. sc
				.. "</code> will change '''Step offset''' to '''Semitones''' in the case of [["
				.. sc .. "edo]]"
				.. ((s >= 2) and {", since " .. sc .. "edo is a superset of [[12edo]]."} or {"."})[1]
		end
		
		if s >= 3 then
			out_str = out_str
				.. "\n\n<h3>See also</h3>\n"
				.. "* [[Alternative symbols for ups and downs notation]]"
		end
	end
	
	local debugg = frame.args["debug"]
	return frame:preprocess(debugg == "true" and "<pre>" .. out_str .. "</pre>" or out_str)
end

return p