Module:Years generator

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

This module can be used to transclude a particular template for each year since a given year. It will produce a bolded year, followed by an Em dash, followed by your template, for each year from the year you specify (inclusive) up to the current year (inclusive).

Direct usage

Copy and paste the following code, substituting "start year" for the year you want to start the iteration from, and "template to transclude" with the template you want:

{{#invoke:Years generator|templateEveryYearToPresent|Start year|Template to transclude}}

This will result in the template being called for each year from Start year to the current year, with the year it's being called for as the first and only argument.

Usage in a template

Copy and paste the following code, substituting "template to transclude" with the template you want:

{{#invoke:Years generator|templateEveryYearToPresent|Template to transclude}}

The parameters that your template's users put after your template will be automatically consumed by this module, and passed on to the template that you are transcluding for each year. If you wish to consume some parameters yourself, add them to a comma-separated list in a parameter |templatedonotconsume=. These parameters will be ignored by the module.

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

local p = {} --p stands for package

function p.templateEveryYearToPresent ( frame )
	years = yearsFromYearToPresent(frame.args[1])
	toReturn = ""
	for index, year in pairs( years ) do
		toReturn = toReturn .. ( index == 0 and '' or "\n" )
	    toReturn = toReturn .. "'''" .. tostring(year) .. "''': "
	    .. frame:expandTemplate{ title = frame.args[2], args = { tostring( year ) } }
	end
	return toReturn
end

function yearsFromYearToPresent( year )
	startyear = tonumber( year )
	if ( startyear == nil )
	then
		error( "Invalid start year provided" )
	end
	
	years = {}
    numyears = ( tonumber( os.date( "%Y" ) ) - startyear )
    for numadded = 0, numyears do -- equiv of i = 0; i <= numyears; i++
    	years[numadded] = startyear + numadded
    end
	return years
end

return p