Difference between revisions of "Module:Main"

From blackwiki
Jump to navigation Jump to search
blackwiki>Zondor
(→‎See also: background, details)
m (184 revisions imported)
 
(100 intermediate revisions by 44 users not shown)
Line 1: Line 1:
:''Main article{{if
+
--[[
|{{{2|}}}|s}}: {{if
+
-- This module produces a link to a main article or articles. It implements the
  |{{{1|}}}|[[{{{1}}}]]{{if
+
-- template {{main}}.
  |{{{2|}}}|, [[{{{2}}}]]{{if
+
--  
    |{{{3|}}}|, [[{{{3}}}]]{{if
+
-- If the module is used in category or category talk space, it produces "The
    |{{{4|}}}|, [[{{{4}}}]]{{if
+
-- main article for this category is xxx". Otherwise, it produces
      |{{{5|}}}|, [[{{{5}}}]]{{if
+
-- "Main article: xxx".
      |{{{6|}}}|, [[{{{6}}}]]{{if
+
--]]
        |{{{7|}}}|, [[{{{7}}}]]{{if
 
        |{{{8|}}}|, [[{{{8}}}]]{{if
 
          |{{{9|}}}|, [[{{{9}}}]]{{if
 
          |{{{10|}}}|, [[{{{10}}}]]{{if
 
            |{{{11|}}}|, [[{{{11}}}]]{{if
 
            |{{{12|}}}|, [[{{{12}}}]]{{if
 
              |{{{13|}}}|, [[{{{13}}}]]{{if
 
              |{{{14|}}}|, [[{{{14}}}]]{{if
 
                |{{{15|}}}|, [[{{{15}}}]]{{if
 
                |{{{16|}}}|, [[{{{16}}}]]{{if
 
                  |{{{17|}}}|, [[{{{17}}}]]{{if
 
                  |{{{18|}}}|, [[{{{18}}}]]{{if
 
                    |{{{19|}}}|, [[{{{19}}}]]{{if
 
                    |{{{20|}}}|, [[{{{20}}}]]}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}}''<noinclude>
 
----
 
{{esoteric}}
 
:''Please be mindful of the talk page discussions that have determined '''Template:Main''''s appearance.''
 
__NOTOC__
 
==Purpose of template==
 
When [[Wikipedia:What is an article|Wikipedia article]]s
 
become too large, subarticles are usually created. This [[Wikipedia:Template messages|template]], used in the subarticle, uses the name of the main article as a [[m:Help:Template#Parameters|parameter]] to produce a link to the main article:
 
  
<nowiki>
+
local mHatnote = require('Module:Hatnote')
{{main|Article}}
+
local mHatlist = require('Module:Hatnote list')
</nowiki>
+
local mArguments -- lazily initialise
 +
local p = {}
  
will produce
+
function p.main(frame)
{{main|Article}}
+
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 #pages == 0 and mw.title.getCurrentTitle().namespace == 0 then
 +
return mHatnote.makeWikitextError(
 +
'no page names specified',
 +
'Template:Main#Errors',
 +
args.category
 +
)
 +
end
 +
local options = {
 +
selfref = args.selfref
 +
}
 +
return p._main(pages, options)
 +
end
  
To reference multiple articles, the {{tl|main articles}} template can be used instead, as so:
+
function p._main(args, options)
 +
-- Get the list of pages. If no first page was specified we use the current
 +
-- page name.
 +
local currentTitle = mw.title.getCurrentTitle()
 +
if #args == 0 then args = {currentTitle.text} end
 +
local firstPage = string.gsub(args[1], '|.*$', '')
 +
-- Find the pagetype.
 +
local pageType = mHatnote.findNamespaceId(firstPage) == 0 and 'article' or 'page'
 +
-- Make the formatted link text
 +
list = mHatlist.andList(args, true)
 +
-- Build the text.
 +
local isPlural = #args > 1
 +
local mainForm
 +
local curNs = currentTitle.namespace
 +
if (curNs == 14) or (curNs == 15) then --category/talk namespaces
 +
mainForm = isPlural and
 +
'The main %ss for this [[Help:Categories|category]] are %s'
 +
or
 +
'The main %s for this [[Help:Categories|category]] is %s'
 +
else
 +
mainForm = isPlural and 'Main %ss: %s' or 'Main %s: %s'
 +
end
 +
local text = string.format(mainForm, pageType, list)
 +
-- Process the options and pass the text to the _rellink function in
 +
-- [[Module:Hatnote]].
 +
options = options or {}
 +
local hnOptions = {
 +
selfref = options.selfref
 +
}
 +
return mHatnote._hatnote(text, hnOptions)
 +
end
  
<nowiki>
+
return p
{{main articles}} [[a]], [[b]], [[c]]
 
</nowiki>
 
 
 
which produces:
 
{{main articles}} [[a]], [[b]], [[c]]
 
 
 
== Comparison with related templates ==
 
 
 
The following two are meant to be used in connection with each other:
 
 
 
* At the top of a brief section concerning a subject that has a more detailed article (this is the only form specified by the [[Wikipedia:Summary style|Wikipedia Manual of Style]]);
 
* ''or'' at the top of the specialized article, to refer to the more general article: {{tiwt|main}}
 
* at the top or bottom of a section of the more general article, to refer to the specialized article: {{tiwt|see details}}
 
----
 
The following set of two is an alternative:
 
*{{tiwt|subarticleof}}
 
*{{tiwt|seesubarticle}}
 
 
 
==References==
 
* [[Wikipedia:Long article layout]]
 
* [[Wikipedia:Summary style]]
 
* [[m:Help:Template]]
 
 
 
==See also==
 
* {{tl|Main}}, {{tl|Main2}}
 
* {{tl|Background}}
 
* {{tl|Details}}
 
* {{tl|See}}, {{tl|See2}}, {{tl|See3}}, {{tl|See4}}, {{tl|See5}}
 
* {{tl|See also}}, {{tl|Seealso2}}, {{tl|Seealso3}}, {{tl|Seealso4}}, {{tl|Seealso5}}, {{tl|Seealso6}}, {{tl|Seealso7}}, {{tl|Seealso8}}
 
</noinclude>
 

Latest revision as of 09:49, 21 September 2020

This module produces a link to a main article or articles. It implements the {{main}} template. Normally, it produces a link like "Main article: A". If used in the category namespace, it produces a link like "The main article for this category is A". It is possible to specify multiple articles, and in this case plural wording is used automatically. If the first link is not an article, the module uses the wording "Main page" instead of "Main article".

Usage from wikitext

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

Usage from other Lua modules

Load the module:

local mMain = require('Module:Main')

You can then use the _main function like this:

mMain._main(args, options)

The args parameter following options are a list 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). Category or file links are automatically escaped using the colon trick. If a link includes a section name, and no display value is set, links are automatically formatted as page § section, rather than the MediaWiki default of page#section.

The optional options table can be used to configure the function's output. At present, 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

mMain._main({'A'})

Produces:

<div role="note" class="hatnote navigation-not-searchable">Main article: [[A]]</div>

Displays as:

Example 2

mMain._main({'Wikipedia:Categorization', 'Help:Category', 'Category:Wikipedia categories'})

Produces:

<div role="note" class="hatnote navigation-not-searchable">Main pages: [[Wikipedia:Categorization]], [[Help:Category]] and [[:Category:Wikipedia categories]]</div>

Displays as:

Example 3

mMain._main({'A|the letter "A"', 'B|the letter "B"', 'C|the letter "C"'})

Produces:

<div role="note" class="hatnote navigation-not-searchable">Main articles: [[A|the letter "A"]], [[B|the letter "B"]] and [[C|the letter "C"]]</div>

Displays as:

Example 4

mMain._main({'Wikipedia:Verifiability#Burden'}, {selfref = true})

Produces:

<div role="note" class="hatnote navigation-not-searchable selfref">Main article: [[Wikipedia:Verifiability#Burden|Wikipedia:Verifiability § Burden]]</div>

Displays as:

Example 5 (if used in the category namespace)

mMain._main({'A'})

Produces:

<div role="note" class="hatnote navigation-not-searchable">The main article for this [[Wikipedia:Categorization|category]] is [[A]]</div>

Displays as:

Technical details

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 link to a main article or articles. It implements the
-- template {{main}}.
-- 
-- If the module is used in category or category talk space, it produces "The
-- main article for this category is xxx". Otherwise, it produces
-- "Main article: xxx".
--]]

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

function p.main(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 #pages == 0 and mw.title.getCurrentTitle().namespace == 0 then
		return mHatnote.makeWikitextError(
			'no page names specified',
			'Template:Main#Errors',
			args.category
		)
	end
	local options = {
		selfref = args.selfref
	}
	return p._main(pages, options)
end

function p._main(args, options)
	-- Get the list of pages. If no first page was specified we use the current
	-- page name.
	local currentTitle = mw.title.getCurrentTitle()
	if #args == 0 then args = {currentTitle.text} end
	local firstPage = string.gsub(args[1], '|.*$', '')
	-- Find the pagetype.
	local pageType = mHatnote.findNamespaceId(firstPage) == 0 and 'article' or 'page'
	-- Make the formatted link text
	list = mHatlist.andList(args, true)
	-- Build the text.
	local isPlural = #args > 1
	local mainForm
	local curNs = currentTitle.namespace
	if (curNs == 14) or (curNs == 15) then --category/talk namespaces
		mainForm = isPlural and
			'The main %ss for this [[Help:Categories|category]] are %s'
			or
			'The main %s for this [[Help:Categories|category]] is %s'
	else
		mainForm = isPlural and 'Main %ss: %s' or 'Main %s: %s'
	end
	local text = string.format(mainForm, pageType, list)
	-- Process the options and pass the text to the _rellink function in
	-- [[Module:Hatnote]].
	options = options or {}
	local hnOptions = {
		selfref = options.selfref
	}
	return mHatnote._hatnote(text, hnOptions)
end

return p