查看“︁模板:Hatnote/doc”︁的源代码

{{Documentation subpage}}
{{High-use|106353}}
{{Template shortcut|HAT}}
{{lua|Module:Hatnote}}

本模板生成遵循'''[[维基百科:顶注]]'''指引的格式化文本。
<!-- This template produces formatted text, following the guideline for a '''[[Wikipedia:頂註|Wikipedia hatnote]]'''.-->
:<code><nowiki>{{hatnote|Example hatnote text.}}</nowiki></code> &rarr;<br><!-- a construct to show hatnote as expected (using newline) -->
{{hatnote|Example hatnote text.}}

简单来说，顶注（{{lang|en|hatnote}}）告知读者：是否在正确的页面。
<!-- Broadly speaking, a hatnote should answer a readers' question (maybe preemptively): ''Am I on the right page?'' -->

{{TOC limit}}

== 功能 ==
This template is primarily used to add a correctly formatted ''hatnote'' to a page. Often, but not always, this is a ''disambiguation link'' at the top of article pages. It places an HTML <code>div-</code> / <code>div</code> block around the text entered as its only argument, which provides standardized formatting (contents are indented and italicized in most displays); it also isolates the contained code to make sure that it is interpreted correctly.

This template is also used as the "meta-template" for additional specialized disambiguation link templates; see [[:Category:顶注模板]] for a list.

The template does not automatically create links of any kind. Links and other desired formatting must be explicitly added, using normal [[Wikipedia:Cheatsheet|Wikipedia markup]].

== 用法 ==

; 基本用法：
 &#123;{hatnote|''text''}}

; 全部参数：
 &#123;{hatnote|''text''|extraclasses=''extra classes''|selfref=''yes''|category=''no''}}

== 参数 ==

本模板接受如下参数：
<!-- This template accepts the following parameters: -->
* <code>1</code> - the hatnote text (required)
* <code>extraclasses</code> - any extra CSS classes to be added - For example, the {{tl|see also}} template adds the classes "{{para|extraclasses|boilerplate seealso}}".
* <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.
* <code>category</code> - If set to "no", "n", "false", or "0", suppresses the error tracking category ([[:Category:Hatnote templates with errors]]). This has an effect only if the <!--"first-positional parameter", not "first positional parameter", if you value the readers' time ... but better yet --> leftmost parameter (the hatnote text) is omitted.

== 举例 ==

* <code><nowiki>{{hatnote|Example hatnote text}}</nowiki></code> → {{hatnote|Example hatnote text}}

== 错误 ==

如果模板未填写顶注文本参数，会输出如下提示内容：
<!-- If no hatnote text is supplied, the template will output the following message: -->
* {{hatnote|category=no}}

如果看到该错误，可能有以下原因：
<!-- If you see this error message, it is for one of four reasons: -->
# No parameters were specified (the template code was <code><nowiki>{{hatnote}}</nowiki></code>). Please use <code><nowiki>{{hatnote|</nowiki>''text''<nowiki>}}</nowiki></code> instead.
# Some parameters were specified, but the hatnote text wasn't included. For example, the template text <code><nowiki>{{hatnote|extraclasses=seealso}}</nowiki></code> will produce this error. Please use (for example) <code><nowiki>{{hatnote|</nowiki>''text''<nowiki>|extraclasses=seealso}}</nowiki></code> instead.
# The hatnote text was specified, but that text contains an equals sign ("="). The equals sign has a special meaning in template code, and because of this it cannot be used in template parameters that do not specify a parameter name. For example, the template code <code><nowiki>{{hatnote|2+2=4}}</nowiki></code> will produce this error. To work around this, you can specify the parameter name explicitly by using <code>1=</code> before the hatnote text, like this: <code><nowiki>{{hatnote|1=2+2=4}}</nowiki></code>.
# You tried to access [[Module:Hatnote]] directly by using <code><nowiki>{{#invoke:hatnote|hatnote|</nowiki>''text''<nowiki>}}</nowiki></code>. Use of #invoke in this way has been disabled for performance reasons. Please use <code><nowiki>{{hatnote|</nowiki>''text''<nowiki>}}</nowiki></code> instead.

If you see this error message and are unsure of what to do, please post a message on [[Template talk:Hatnote]], and someone should be able to help you.

Pages that contain this error message are tracked in [[:Category:Hatnote templates with errors]].

== 技术细节 ==

The HTML code produced by this template looks like this:

* <code><nowiki><div role="note" class="hatnote"></nowiki>''hatnote text''<nowiki></div></nowiki></code>

The code is produced by [[Module:Hatnote]].

{{Hatnote templates}}
{{Collapse top|[[Wikipedia:TemplateData|TemplateData]] documentation used by [[Wikipedia:VisualEditor|VisualEditor]] and other tools}}
{{TemplateData header|noheader=1}}
<templatedata>
{
  "description": "Template for creating a standard Wikipedia hatnote. A hatnote is a short note placed at the top of an article to provide disambiguation of closely related terms or summarise a topic, explaining its boundaries.",
  "params": {
    "1": {
      "label": "Text",
      "description": "This field should contain the text that will be displayed in the hatnote.",
      "type": "string",
      "required": true
    },
    "extraclasses": {
      "type": "string/line",
      "label": "Extra classes",
      "description": "Extra CSS classes to be added to the <div> tags surrounding the hatnote text."
    },
    "selfref": {
      "type": "string/line",
      "label": "Self reference",
      "description": "Set to \"yes\" if the hatnote text is a self-reference to Wikipedia that would not make sense on mirrors or forks of the Wikipedia site. (E.g. \"For the Wikipedia Sandbox, see [[WP:SAND]]\".)"
    },
    "category": {
      "label": "Category",
      "description": "Set to \"no\", \"n\", \"false\", or \"0\" to suppresses the error tracking category (Category:Hatnote templates with errors). This only has an effect if the hatnote text is omitted."
    }
  }
}
</templatedata>
{{Collapse bottom}}<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox||
[[Category:顶注模板| ]]
[[Category:Cross-reference templates]]
}}</includeonly>