Editing Template:Main/doc

{{Lua|icononly=on|Module:Labelled list hatnote}}

{{hatnote|This template is for linking to main content. For the mainspace detection template, see [[:template:main other]].}}
When an article is large, it is often written in summary style. This template is used after the heading of the summary, to link to the subtopic article that has been summarized. For [[Help:Category|Category namespace]], please use '''{{tl|Cat main}}''' instead.

Use of this template should be restricted to the purposes described above. It is {{em|not}} to be used as a substitute for inline links or {{tl|Further}} template. The latter is used when the section expounds a specific aspect of the topic instead of summarizing its article.
Do not use this template on top of a page (such as above the lead), where hatnotes are for disambiguation and not for related topics. A lead section is always a summary of its own article, not any other; as such, the only appropriate target for a {{tl|Main}} link in the lead section would be the article itself, which is not useful.

{{TOC limit}}

==Usage==
{{see|WP:SUMMARYHATNOTE}}
{{startplainlist}}
* {{vad|Basic usage:|7.5em|left}} <code>{{((}}{{BASEPAGENAME}}{{!}}{{var|page}}{{))}}</code>
* {{vad|All parameters:|7.5em|left}} <code>{{((}}{{BASEPAGENAME}}{{!}}{{var|page1}}{{!}}{{var|page2}}{{!}}{{var|page3}}{{!}}&nbsp;...&nbsp;{{!}}l1&nbsp;{{=}}&nbsp;{{var|label1}}{{!}}l2&nbsp;{{=}}&nbsp;{{var|label2}}{{!}}l3&nbsp;{{=}}&nbsp;{{var|label3}}{{!}}&nbsp;...&nbsp;{{!}}selfref&nbsp;{{=}}&nbsp;{{var|yes}}{{))}}</code>
{{endplainlist}}

==Parameters==
*<code>1</code>, <code>2</code>, <code>3</code>, ... – the pages to link to. If no page names are specified, the current page name is used instead (without the [[Wikipedia:Namespace|namespace]] prefix). Categories and files are automatically escaped with the [[Help:Colon trick|colon trick]], and links to sections are automatically formatted as ''page § section'', rather than the MediaWiki default of ''page#section''.
*<code>l1</code>, <code>l2</code>, <code>l3</code>, ... ''or''<code>label 1</code>, <code>label 2</code>, <code>label 3</code>, ... – optional labels for each of the pages to link to (this is for articles where a piped link would be used). Note that the extra parameters use a lower case 'L', for example, <code>l1</code>, <u>not</u> <code>L1</code>.
*<code>selfref</code> – if set to "yes", "y", "true" or "1", adds the CSS class "selfref". This is used to denote self-references to RTC Wiki. See [[Template:Selfref]] for more information. This is only necessary in articles and other content (e.g. templates) that will appear in articles, and need not be added for uses of this template on <code>RTC Wiki:</code> namespace pages.

==Template data==
{{TemplateData header}}
<templatedata>
{
	"description": "This template is used after the heading of a section, to link to a sub-article (or sub-articles) that is entirely about the topic of the section. The template will display, in italics, \"Main article: Article 1, Article 2 and Article 3\"",
	"params": {
		"1": {
			"label": "Page 1",
			"description": "The name of the first page that you want to link to. If this is not specified, the current page name (with no namespace prefix) is used instead. ",
			"type": "wiki-page-name",
			"required": true,
			"suggested": true
		},
		"2": {
			"label": "Page 2",
			"description": "The name of the second page that you want to link to.",
			"type": "wiki-page-name",
			"required": false
		},
		"3": {
			"label": "Page 3",
			"description": "The name of the third page that you want to link to. More pages can be added using the parameters \"4\", \"5\", etc.",
			"type": "wiki-page-name",
			"required": false
		},
		"4": {
			"label": "Page 4",
			"description": "The name of the fourth page that you want to link to.",
			"type": "wiki-page-name"
		},
		"5": {
			"label": "Page 5",
			"description": "The name of the fifth page that you want to link to.",
			"type": "wiki-page-name"
		},
		"l1": {
			"type": "string",
			"label": "Label 1",
			"description": "What the first linked page is to be displayed as.",
			"aliases": [
				"label 1"
			]
		},
		"l2": {
			"label": "Label 2",
			"description": "What the second linked page is to be displayed as.",
			"type": "string",
			"aliases": [
				"label 2"
			]
		},
		"l3": {
			"label": "Label 3",
			"description": "What the third linked page is to be displayed as. Other labels can be added by using increasing numbers (starting with \"l4\" for page 4) as parameter names.",
			"type": "string",
			"aliases": [
				"label 3"
			]
		},
		"selfref": {
			"type": "boolean",
			"label": "Self reference",
			"description": "Set to \"yes\" if the template is a self-reference to RTC Wiki that would not make sense on mirrors or forks of the RTC Wiki site."
		},
		"l4": {
			"aliases": [
				"label 4"
			],
			"label": "Label 4",
			"description": "What the fourth linked page is to be displayed as.",
			"type": "string"
		},
		"l5": {
			"aliases": [
				"label 5"
			],
			"label": "Label 5",
			"description": "What the fifth linked page is to be displayed as.",
			"type": "string"
		}
	},
	"paramOrder": [
		"1",
		"2",
		"3",
		"4",
		"5",
		"l1",
		"l2",
		"l3",
		"l4",
		"l5",
		"selfref"
	],
	"format": "{{_|_ = _}}\n"
}
</templatedata>

==Examples==
{{hatnote|Underscores (_) between words are not necessary}}
*<code><nowiki>{{Main}}</nowiki></code> &rarr; {{main|category=no}}
*<code><nowiki>{{Main|Article}}</nowiki></code> &rarr; {{main|Article}}
*<code><nowiki>{{Main|Article#Section title}}</nowiki></code> &rarr; {{main|Article#Section title}}
*<code><nowiki>{{Main|Article#Section|l1=Custom section label}}</nowiki></code> &rarr; {{main|Article#Section|l1=Custom section label}}
*<code><nowiki>{{Main|Article1|Article2|Article3}}</nowiki></code> &rarr; {{main|Article1|Article2|Article3}}
*<code><nowiki>{{Main|Article1|l1=Custom label 1|Article2|l2=Custom label 2}}</nowiki></code> &rarr; {{main|Article1|l1=Custom label 1|Article2|l2=Custom label 2}}
*<code><nowiki>{{Main|(15760) 1992 QB1|l1={{mp|(15760) 1992 QB|1}}}}</nowiki></code> &rarr; {{main|(15760) 1992 QB1|l1={{mp|(15760) 1992 QB|1}}}}

==Errors==
If the name of the first page that you want to link to is not specified, the current page name (with no namespace prefix) is used instead:
*{{Main|category=no}}

No errors can be displayed due to the illegal usage of parameters or other usages (i.e. the first parameter can be omitted, other parameters can be used even if the first one is empty (and automatically filled with the current page name (with no namespace prefix)), equals sign can be used as one of the parameters, and template can be used by direct call to the module (using "#invoke")). This is not the case for {{tl|see also}}, for example.