Template:Hatnote/doc

This template formats text into the standard stylistic for a Wikipedia hatnote. It produces a short note placed at the top of an article to provide disambiguation of closely related terms or summarise a topic, explaining its boundaries. Hatnotes look like this:

Function
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  /   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:Hatnote templates 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 markup.

Usage
&#123;{hatnote|text}}
 * Basic usage:

&#123;{hatnote|text|extraclasses=extra classes|selfref=yes|category=no}}
 * All parameters:

Parameters
This template accepts the following parameters:
 * - the hatnote text. (required)
 * - any extra CSS classes to be added. For example, the see also template adds the classes boilerplate seealso.
 * - 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.
 * - if set to "no", "n", "false", or "0", suppresses the error tracking category (Category:Hatnote templates with errors). This only has an effect if the first positional parameter (the hatnote text) is omitted.

Example

 * &rarr;

Errors
If no hatnote text is supplied, the template will output the following message:

If you see this error message, it is for one of three reasons:
 * 1) No parameters were specified (the template code was  ). Please use   instead.
 * 2) Some parameters were specified, but the hatnote text wasn't included. For example, the template text   will produce this error. Please use (for example)   instead.
 * 3) 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   will produce this error. To work around this, you can specify the parameter name explictly by using   before the hatnote text, like this:.

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.

Technical details
The HTML code produced by this template looks like this:



The code is produced by Module:Hatnote.

{ "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 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." } } }