Module:Further

From Guild of Archivists

This module produces a "Further information: a, b and c" link. It implements the {{further}} template.

Usage from wikitext[edit source]

This module cannot be used directly from #invoke. Instead, it can only be used through the {{further}} template. Please see the template page for documentation.

Usage from other Lua modules[edit source]

Load the module:

local mFurther = require('Module:Further')

You can then use the _further function like this:

mDetails._further(pages, options)

The pages argument should be a table of page link strings; if they use custom display values, each string should be preprocessed into a single piped string (e.g. page|display value). Links specifying a section are automatically formatted as page § section, rather than the MediaWiki default of page#section, if no custom display value is set.

The options argument is an optional configuration table. At current, the only option available is "selfref", which is used when the output is a self-reference to Wikipedia. to set this option, use {selfref = true}. (See the {{selfref}} template for more details on self-references.)

Example 1[edit source]

mFurther._further({'A'})

Produces:

<div role="note" class="hatnote">Further information: [[A]]</div>

Displays as:

Further information: A

Example 2[edit source]

mFurther._further({'A', 'B', 'C'})

Produces:

<div role="note" class="hatnote">Further information: [[A]], [[B]] and [[C]]</div>

Displays as:

Further information: A, B, and C

Example 3[edit source]

mFurther._further({'A#D', 'B#D', 'C#D'}, {selfref = true})

Produces:

<div role="note" class="hatnote selfref">Further information: [[A#D|A § D]], [[B#D|B § D]] and [[B#D|C § D]]</div>

Displays as:

Further information: A § D, B § D, and C § D

Technical details[edit source]

This module uses Module:Hatnote to format the hatnote text, Module:Hatnote list to process the list of links, and Module:Arguments to fetch the arguments from wikitext.


--[[
-- This module produces a "Further information: a, b and c" link. It implements
-- the {{further}} template.
--]]

local mHatnote = require('Module:Hatnote')
local mHatlist = require('Module:Hatnote list')
local mTableTools -- lazily initialise
local mArguments -- lazily initialise
local p = {}

function p.further(frame)
	mTableTools = require('Module:TableTools')
	mArguments = require('Module:Arguments')
	local args = mArguments.getArgs(frame, {parentOnly = true})
	local pages = mTableTools.compressSparseArray(args)
	if #pages < 1 then
		return mHatnote.makeWikitextError(
			'no page names specified',
			'Template:Further#Errors',
			args.category
		)
	end
	local options = {
		selfref = args.selfref
	}
	return p._further(pages, options)
end

function p._further(pages, options)
	local text = 'Further information: ' .. mHatlist.andList(pages, true)
	return mHatnote._hatnote(text, options)
end

return p