Module:Further

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

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

Usage from wikitext

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

Load the module:

local mFurther = require('Module:Further')

You can then use the _further function like this:

mDetails._further(options, ...)

The parameters following options are the page names that appear after the "Further information:" text. Page names can include a section link if desired. Pages with section links are automatically formatted as page § section, rather than the MediaWiki default of page#section.

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

Example 1

mFurther._further(nil, 'A')

Produces:

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

Displays as:

Further information: A

Example 2

mFurther._further(nil, 'A', 'B', 'C')

Produces:

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

Displays as:

Further information: A, B and C

Example 3

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

Produces:

<div 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

This module uses Module:Hatnote to format the hatnote text, Module:TableTools 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 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(options, unpack(pages))
end

function p._further(options, ...)
	local links = mHatnote.formatPages(...)
	local text = 'Further information: ' .. mw.text.listToText(links)
	return mHatnote._hatnote(text, options)
end

return p