This module produces a "See also: a, b and c" link. It implements the {{See also}} template.

Usage from wikitext

ಬದಲಾಯಿಸಿ

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

Usage from other Lua modules

ಬದಲಾಯಿಸಿ

Load the module:

local mSeealso = require('Module:See also')

You can then use the _seealso function like this:

mSeealso._seealso(options, ...)

The parameters following options are a list of link/display tables, used to generate the see also links. The first value in each table is the link, and is required. The link can be just a page name, or can include a section link if desired. Links specifying a section are automatically formatted as page § section, rather than the MediaWiki default of page#section.

The second value in each table is the display value, and is optional.

The options variable is an optional configuration table. The following fields are recognised:

  • altphrase - an alternative phrase to "See also". Should be a string, if specified.
  • selfref - set to true to flag the output as a self-reference to Wikipedia. (See the {{Selfref}} template for more details on self-references.)
Example 1
mSeealso._seealso(nil, {'A'})

Produces:

<div class="hatnote boilerplate seealso">See also: [[A]]</div>

Displays as:

Example 2
mSeealso._seealso(nil, {'A'}, {'B'}, {'C'})

Produces:

<div class="hatnote boilerplate seealso">See also: [[A]], [[B]] and [[C]]</div>

Displays as:

Example 3
mSeealso._seealso(nil, {'A', 'the letter "A"'}, {'B', 'the letter "B"'}, {'C', 'the letter "C"'})

Produces:

<div class="hatnote boilerplate seealso">See also: [[A|the letter "A"]], [[B|the letter "B"]] and [[C|the letter "C"]]</div>

Displays as:

Example 4
mSeealso._seealso({altphrase = 'Another page to see', selfref = true}, {'A#B'})

Produces:

<div class="hatnote boilerplate seealso selfref">Another page to see: [[A#B|A § B]]</div>

Displays as:

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 "See also: a, b, and c" link. It implements the
-- template {{see also}}.
--]]

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

function p.seeAlso(frame)
	mArguments = require('Module:Arguments')
	local args = mArguments.getArgs(frame, {parentOnly = true})
	local pages = {}
	for k, v in pairs(args) do
		if type(k) == 'number' then
			local display = args['label ' .. k] or args['l' .. k]
			local page = display and
				string.format('%s|%s', string.gsub(v, '|.*$', ''), display) or v
			pages[#pages + 1] = page
		end
	end
	if not pages[1] then
		return mHatnote.makeWikitextError(
			'no page names specified',
			'Template:See also#Errors',
			args.category
		)
	end
	local options = {
		selfref = args.selfref
	}
	return p._seeAlso(pages, options)
end

function p._seeAlso(args, options)
	checkType('_seeAlso', 1, args, 'table')
	checkType('_seeAlso', 2, options, 'table', true)
	options = options or {}
	local list = mHatlist.andList(args, true)
	local text = string.format('See also: %s', list)
	-- Pass options through.
	local hnOptions = {
		selfref = options.selfref
	}
	return mHatnote._hatnote(text, hnOptions)
end

return p