Module:FindYDCportal

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

A helper module to find the most specific chronology portal which actually exists for a given year or decade. Used to simplify linking to a chronology portal.

October 2019 update

All by-year and by-century portals have been deleted. There are now only 8 decade portals, listed in Category:Decades portals.

So all checking for century and year portals has been disabled.

If any of the decade portals are deleted, then this module should be edited to remove that decade from the table existingDecadePortals

Parameters

Takes one parameter, which must be either a year (e.g. "1879", "1123") or a decade (e.g. "1940s", "730s").

If the parameter is missing, empty, or does not fit the required format, an empty string is returned.

Output

If a portal is found, returns its name without the namespace prefix, e.g.

• for "Portal:1980s" return 1980s
• for "Portal:19th century" return 19th century

If no portal is found, it returns an empty string.

Usage

Year parameter

{{#invoke: FindYDCportal | findydcportal |YYYY}} ... where YYYY is a 3- or 4-digit year

Decade parameter

{{#invoke: FindYDCportal | findydcportal |YYY0s}} ... where YYY0s is a 3- or 4-digit decade

Examples

Years

• {{#invoke: FindYDCportal | findydcportal |2018}} →
• {{#invoke: FindYDCportal | findydcportal |1935}} →
• {{#invoke: FindYDCportal | findydcportal |1857}} →
• {{#invoke: FindYDCportal | findydcportal |736}} →
• {{#invoke: FindYDCportal | findydcportal |1800}} →

Decades

• {{#invoke: FindYDCportal | findydcportal |2000s}} →
• {{#invoke: FindYDCportal | findydcportal |1940s}} →
• {{#invoke: FindYDCportal | findydcportal |560s}} →

Missing parameter

• {{#invoke: FindYDCportal | findydcportal}} →

Empty parameter

• {{#invoke: FindYDCportal | findydcportal | }} →

Invalid parameter

• {{#invoke: FindYDCportal | findydcportal | 1927-related}} →
• {{#invoke: FindYDCportal | findydcportal | Swedish chef}} →

Logic

If the parameter is a year:

1. If the year portal exists, return its name.
   Otherwise try the decade.
2. If the decade portal exists, return its name.
   Otherwise try the century
3. If the century portal exists, return its name.
   Otherwise return an empty string

If the parameter is a decade:

1. If the decade portal exists, return its name.
   Otherwise try the century
2. If the century portal exists, return its name.
   Otherwise return an empty string

See also

• Template:Portal
• Template:Portalbar
• Wikipedia:Portals

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

local p = {}

-- check for the existence of a portal with the given name
-- if it exists, returns the name
-- otherwise returns nil
function checkPortalExists(portalName)
	local portalPage = mw.title.new( portalName, "Portal" )
	if (portalPage.exists) then
		return portalName
	end
	return nil
end


-- check for the existence of a portal with the name of that year
-- if it exists, returns the year
-- otherwise calls decadeCheck, and returns that result
-- otherwise returns nil
function checkYear(year)
	if checkPortalExists(year) then
		return year
	end
	-- myDecade = the year, with the last digit stripped
	--            e.g. "1694" → "1690"
	--            Note that a deacde is written as usul=ally written "YYY0s"
	local myDecade = mw.ustring.gsub(year, "%d$", "0s")
	return checkDecade(myDecade)
end

-- check for the existence of a portal with the name of that decades
-- if it exists, returns the year
-- otherwise calls decadeCheck, and returns that result
-- otherwise returns nil
function checkYear(year)
	if checkPortalExists(year) then
		return year
	end
	-- myDecade = the year, with the last digit replaced with "0"
	--            e.g. "1694" → "1690"
	local myDecade = mw.ustring.gsub(year, "%d$", "0s")
	return checkDecade(myDecade)
end

function p.main(frame)
	--Expects one paramter
	-- {{{1}}}= a 3- or 4-digit year or deacde
	--    e.g. 1916
	--         1504
	--         1630s
	--         920s
	local arg1 = frame.args[1]
	if arg1 == nil
	then
		return ""
	end
	if (mw.ustring.match(arg1, "^%d%d%d%d?$")) then
		-- it's a 3- or 4-digit-year
		return checkYear(arg1)
	elseif (mw.ustring.match(arg1, "^%d%d%d?0s$")) then
		-- it's a 3- or 4-digit decade
		-- so strip the trailing "0s"
		local decadeArg = mw.ustring.gsub(arg1, "^(%?d%d%d)0s$", "%1")
		return checkDecade(decadeArg)
	end
	-- If we get here, then arg1 was neither a year nor a decade
	-- This is going to be a helper template, and diagnostics woud be intrusive
	-- So just return an empty string
	return ""
end

return p