模板:Main/doc：修订间差异

2024年1月20日 (六) 21:46的最新版本

This is a documentation subpage for 模板:Main.
It may contain usage information, categories and other content that is not part of the original 模板 page.

This template is used on approximately 347,000 pages, or roughly 7794% of all pages.
To avoid major disruption and server load, any changes should be tested in the template's /sandbox or /testcases subpages, or in your own user subpage. The tested changes can be added to this page in a single edit. Consider discussing changes on the talk page before implementing them.

This template uses Lua:

Module:Labelled list hatnote

When a Wikipedia 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 Category namespace, please use {{Cat main}} instead.

Use of this template should be restricted to the purposes described above. It is not to be used as a substitute for inline links or {{Further}} template. The latter is used when the section expounds a specific aspect of the topic instead of summarizing its article. For example, in phthalate, the template under the "Endocrine disruptor" section should not be {{Main|Endocrine disruptor}}, because the section specifically deals with phthalate as an endocrine disruptor and not endocrine disruptors in general.

This template should also not be used in lead sections. A lead section is always a summary of its own article, not any other; as such, the only appropriate target for a {{Main}} link in the lead section would be the article itself, which is not useful. {{Broader}} may be appropriate in this case.

Usage

Basic usage: {{Main|page}}
All parameters: {{Main|page1|page2|page3| ... |l1 = label1|l2 = label2|l3 = label3| ... |selfref = yes}}

Parameters

1, 2, 3, ... – the pages to link to. If no page names are specified, the current page name is used instead (without the namespace prefix). Categories and files are automatically escaped with the colon trick, and links to sections are automatically formatted as page § section, rather than the MediaWiki default of page#section.
l1, l2, l3, ... orlabel 1, label 2, label 3, ... – 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, l1, not L1.
selfref – if set to "yes", "y", "true" or "1", adds the CSS class "selfref". This is used to denote self-references to Wikipedia. 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 Wikipedia: namespace pages.

Template data

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:Main in articles based on its TemplateData.

TemplateData for Main

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"

模板参数
此模板有自定义格式。
参数		描述	类型	状态
Page 1	`1`	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.	页面名称	必需
Page 2	`2`	The name of the second page that you want to link to.	页面名称	可选
Page 3	`3`	The name of the third page that you want to link to. More pages can be added using the parameters "4", "5", etc.	页面名称	可选
Label 1	`l1label 1`	What the first linked page is to be displayed as.	字符串	可选
Label 2	`l2label 2`	What the second linked page is to be displayed as.	字符串	可选
Label 3	`l3label 3`	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.	字符串	可选
Self reference	`selfref`	Set to "yes" if the template is a self-reference to Wikipedia that would not make sense on mirrors or forks of the Wikipedia site.	布尔	可选

Examples

{{Main}} → Error: no page names specified (help).
{{Main|Article}} →
{{Main|Article#Section title}} →
{{Main|Article#Section|l1=Custom section label}} →
{{Main|Article1|Article2|Article3}} →
{{Main|Article1|l1=Custom label 1|Article2|l2=Custom label 2}} →
{{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:

Error: no page names specified (help).

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 {{see also}}, for example.

@@ 第1行： / 第1行： @@
-{{Documentation|fromWikipedia=true}}
+<noinclude>{{pp-vandalism|small=yes}}</noinclude>{{Documentation subpage}}
+{{High-use}}
+{{Never substitute}}
+{{Lua|icononly=on|Module:Labelled list hatnote}}
-This template is used at the start of a section to link to the main article on that subject.
+{{hatnote|This template is for linking to main content. For the mainspace detection template, see [[:template:main other]].}}
-==TemplateData==
+When a [[Wikipedia:What is an article?|Wikipedia article]] is large, it is often written in [[Wikipedia:Summary style|summary style]]. This [[Wikipedia:Template messages|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 '''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. For example, in [[phthalate]], the template under the "Endocrine disruptor" section should '''not''' be {{tlf|Main|Endocrine disruptor}}, because the section specifically deals with phthalate as an endocrine disruptor and not endocrine disruptors in general.
+This template should also not be used in lead sections. 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. {{tl|Broader}} may be appropriate in this case.
+{{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 Wikipedia. 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>Wikipedia:</code> namespace pages.
+==Template data==
+{{TemplateData header}}
 <templatedata>
 {
@@ 第12行： / 第36行： @@
 			"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": false,
+			"required": true,
 			"suggested": true
 		},
@@ 第70行： / 第94行： @@
 </templatedata>
-<includeonly>[[Category:General wiki templates|{{PAGENAME}}]]</includeonly>
+==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.
+==See also==
+*{{tl|Main list}}: For a more comprehensive list, see {{color|blue|Article}}.
+*{{tl|Broader}}: For broader coverage of this topic, see {{color|blue|Article}}.
+*{{tl|Excerpt}}, which allows transclusion of text (such as an intro section) from one article into another
+*{{tl|Further}}: Further information: {{color|blue|Article}}.
+*{{tl|Official website}}
+{{Hatnote templates}}
+<includeonly>{{sandbox other||
+<!-- Categories go here and interwikis go in Wikidata. -->
+[[Category:Hatnote templates]]
+[[Category:Wikipedia page-section templates]]
+}}</includeonly>

v t e Hatnote templates
Wikipedia:Hatnote Wikipedia:Disambiguation Wikipedia:Redirect
Generic	`{{Hatnote}}` `{{Self-reference}}`
For and about	`{{For}}` `{{For-text}}` (for custom text) `{{For-multi}}` (for multiple uses) `{{About}}` Variations: `{{Other uses}}` `{{Other uses of}}` `{{Redirect-distinguish-for}}` `{{About-distinguish}}` `{{About-distinguish-text}}`
Other topics	`{{Other people}}` `{{About other people}}` (adds "about" description) `{{Similar names}}` `{{Other storms}}` `{{Other places}}` `{{Other ships}}`
Redirect	`{{Redirect}}` `{{Redirect2}}` (for two redirects) `{{Redirect-multi}}` (for multiple redirects) `{{Redirect-several}}` (for several redirects, without listing each) `{{Redirect-synonym}}` `{{Redirect-distinguish}}` `{{Redirect-distinguish-text}}` `{{Redirect-distinguish-for}}` `{{Technical reasons}}`
Distinguish	`{{Distinguish}}` (supports custom text) `{{About-distinguish}}` `{{About-distinguish-text}}` (for custom text) `{{Redirect-distinguish}}` `{{Redirect-distinguish-text}}` (for custom text) `{{Redirect-distinguish-for}}`
For use in sections	`{{Main}}` `{{Main if exists}}` `{{Main list}}` `{{Further}}` `{{Further-text}}` (for custom text) `{{Further interlanguage link}}` `{{See also}}` `{{See also if exists}}` `{{See also-text}}` (for custom text) `{{For outline}}` `{{For timeline}}`
Special	`{{Broader}}` `{{For introduction}}` `{{See Wiktionary}}` `{{Transcluding article}}` `{{Transcluded section}}`
Subject specific	`{{About year}}` `{{Highway detail hatnote}}` `{{For LMST}}` `{{WikiIPA}}`
Category:Hatnote templates modules for [family] names for lists hatnote templates for category pages