Vorlage:Hatnote/doc: Unterschied zwischen den Versionen

K
172 Versionen von wpen:Template:Hatnote/doc importiert
(Returmed {{High-risk}} template - it seems that even template editors and administrators need to see this message after the temporary server crash/overload that happened last week with edits on another highly-transcluded template...)
K (172 Versionen von wpen:Template:Hatnote/doc importiert)
 
(56 dazwischenliegende Versionen von 32 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
{{Documentation subpage}}
{{Documentation subpage}}
{{High-risk|470,000+}}
{{Redirect|Template:Dablink|the maintenance template|Template:Dablinks}}
{{shortcut|T:HAT}}
{{High-use| 369726 }}
{{Never substitute}}
{{lua|Module:Hatnote}}
{{lua|Module:Hatnote}}


This template formats text into the standard stylistic for a [[Wikipedia:Hatnote|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:
This template produces formatted text, following the guideline for a '''[[WP:HATNOTE|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.}}


{{hatnote|Example hatnote text.}}
Broadly speaking, a hatnote should answer a reader's question (maybe preemptively): ''Am I on the right page?''


{{TOC limit}}
{{TOC limit}}
Zeile 18: Zeile 21:


== Usage ==
== Usage ==
; Basic usage:
; Basic usage:
  &#123;{hatnote|''text''}}
  &#123;{hatnote|''text''}}
Zeile 26: Zeile 28:


== Parameters ==
== Parameters ==
This template accepts the following parameters:
This template accepts the following parameters:
* <code>1</code> - the hatnote text. (required)
* <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>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>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 only has an effect if the first positional parameter (the hatnote text) is omitted.
* <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.


== Example ==
== Example ==
 
* <code><nowiki>{{hatnote|Example hatnote text}}</nowiki></code> {{hatnote|Example hatnote text}}
* <code><nowiki>{{hatnote|Example hatnote text}}</nowiki></code> &rarr; {{hatnote|Example hatnote text}}


== Errors ==
== Errors ==
If no hatnote text is supplied, the template will output the following message:
If no hatnote text is supplied, the template will output the following message:
* {{hatnote|category=no}}
* {{hatnote|category=no}}
Zeile 45: Zeile 44:
# No parameters were specified (the template code was <code><nowiki>{{hatnote}}</nowiki></code>). Please use <code><nowiki>{{hatnote|</nowiki>''text''<nowiki>}}</nowiki></code> instead.
# 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.
# 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 explictly by using <code>1=</code> before the hatnote text, like this: <code><nowiki>{{hatnote|1=2+2=4}}</nowiki></code>.
# 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.
# 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.


Zeile 53: Zeile 52:


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


* <code><nowiki><div class="hatnote"></nowiki>''hatnote text''<nowiki></div></nowiki></code>
* {{tag|div|attribs=role="note" class="hatnote navigation-not-searchable"|link=yes|content= hatnote text}}


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


{{Hatnote templates documentation}}
==See also==
{{Collapse top|TemplateData}}
* {{tl|For}}
{{TemplateDataHeader}}
 
{{Hatnote templates}}
{{Collapse top|[[Wikipedia:TemplateData|TemplateData]] documentation used by [[Wikipedia:VisualEditor|VisualEditor]] and other tools}}
{{TemplateData header|noheader=1}}
<templatedata>
<templatedata>
{
{
Zeile 90: Zeile 91:
}
}
</templatedata>
</templatedata>
{{Collapse bottom}}<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox||
{{Collapse bottom}}<includeonly>{{Sandbox other||
[[Category:Hatnote templates| ]]
[[Category:Hatnote templates| ]]
[[Category:Cross-reference templates]]
}}</includeonly>
}}</includeonly>