m (1 revision: Starter Wiki Refresh) |
m (1 revision: Starter Wiki Refresh) |
||
Line 1: | Line 1: | ||
+ | == Description == |
||
− | The hatnotes used for adding links between articles where more context is important. |
||
+ | To use this template, add the {{T|{{BASEPAGENAME}}}} template and fill in the appropriate fields. Fields left blank will not appear in articles. This infobox template uses [[Help:Infobox|Fandom's infobox syntax]]. |
||
− | Broadly speaking, a hatnote should answer a readers' question: Am I on the right page? |
||
− | == |
+ | == Syntax == |
+ | <pre> |
||
+ | {{Item |
||
+ | | title = |
||
+ | | image = [e.g. "Example.jpg"] |
||
+ | | imagecaption = |
||
+ | | type = |
||
+ | | effects = |
||
+ | | source = |
||
+ | | buy = |
||
+ | | sell = |
||
+ | }} |
||
+ | </pre> |
||
+ | == Sample output == |
||
− | ; Basic usage: |
||
+ | {{Item |
||
− | {{hatnote|''text''}} |
||
+ | | title = Power Flower |
||
− | |||
+ | | image = Example.jpg |
||
− | ; All parameters: |
||
+ | | type = Food |
||
− | {{hatnote|''text''|extraclasses=''extra classes''|selfref=''yes''|category=''no''}} |
||
+ | | effects = +1 Fire |
||
− | |||
+ | | source = Vendor |
||
− | == Parameters == |
||
+ | | buy = 5g |
||
− | |||
+ | | sell = 1g |
||
− | This template accepts the following parameters: |
||
+ | }}<pre> |
||
− | * <code>1</code> - the hatnote text (required) |
||
+ | {{Item |
||
− | * <code>extraclasses</code> - any extra CSS classes to be added. |
||
+ | | title = Power Flower |
||
− | * <code>selfref</code> - If set to "yes", "y", "true" or "1", adds the CSS class "selfref". This is used to denote self-references. |
||
+ | | image = Example.jpg |
||
− | * <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 leftmost parameter (the hatnote text) is omitted. |
||
+ | | type = Food |
||
− | |||
+ | | effects = +1 Fire |
||
− | == Example == |
||
+ | | source = Vendor |
||
− | |||
+ | | buy = 5g |
||
− | * <code><nowiki>{{hatnote|Example hatnote text}}</nowiki></code> → {{hatnote|Example hatnote text}} |
||
+ | | sell = 1g |
||
− | |||
+ | }} |
||
− | == Typical types == |
||
⚫ | |||
− | {{T|Main}}, {{T|Further}} are very similar, but indicate either the primary page for a topic or more detailed related topic. They have a nearly identical set of parameters. |
||
− | |||
− | ;{{T|Main}}: When an article is large, it often has a summary and a link to a main article. This template is used after the heading of the summary, to indicate a link to the subtopic article that has been summarized. |
||
− | ;{{T|Further}}: Used to link to articles containing further information on this topic. |
||
− | ;{{T|See also}}: Used to link to additional articles on related topics. |
||
− | |||
− | :;{{T|Main|Main Page}} →:{{Main|Main Page}} |
||
− | :;{{T|Main|Main Page|Main Page}} →:{{Main|Main Page|Main Page}} |
||
− | |||
− | :*<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 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. |
||
− | |||
− | |||
− | == Disambiguation == |
||
− | Templates such as {{T|About}} and {{T|For}} are to be used in cases where a disambiguation is not needed. In general, disambiguation pages should only be used for 4 or more titles that are mostly or entirely identical, except for a qualifier. |
||
− | ;{{T|About}}: Links the reader to other articles with similar titles or concepts that they may have been seeking instead. The template has several formats, including: |
||
− | :;{{T|About|Use1}} →:{{About|}} |
||
− | :;{{T|About|Use1|<nowiki/>|Main Page}} →:{{About|Use1||Main Page}} |
||
− | :;{{T|About|Use1|<nowiki/>|Main Page|and|Main Page}} →:{{About|Use1||Main Page|and|Main Page}} |
||
− | :;{{T|About|Use1|Use2|Main Page}} →:{{About|Use1|Use2|Main Page}} |
||
− | :;{{T|About|Use1|Use2|Main Page|and|Main Page}} →:{{About|Use1|Use2|Main Page|and|Main Page}} |
||
− | :;{{T|About|Use1|Use2|Main Page|other uses}} →:{{About|Use1|Use2|Main Page|other uses}} |
||
− | |||
− | Alternately, a <code>section=yes</code> parameter can be added to the {{T|About}} template for use at the top of a section. When using this parameter, the wording in the template changes to specify that it is being used in a section: |
||
− | :;{{T|About|Use1|<nowiki>section=yes</nowiki>}} →:{{About|Use1|section=yes}} |
||
− | :;{{T|About|Use1|<nowiki/>|Main Page|<nowiki>section=yes</nowiki>}} →:{{About|Use1||Main Page|section=yes}} |
||
− | :;{{T|About|Use1|Use2|Main Page|<nowiki>section=yes</nowiki>}} →:{{About|Use1|Use2|Main Page|section=yes}} |
||
− | :;{{T|About|Use1|Use2|Main Page|and|Main Page|<nowiki>section=yes</nowiki>}} →:{{About|Use1|Use2|Main Page|and|Main Page|section=yes}} |
||
− | :;{{T|About|Use1|Use2|Main Page|other uses|<nowiki>section=yes</nowiki>}} →:{{About|Use1|Use2|Main Page|other uses|section=yes}} |
||
− | |||
− | A <var>text</var> option adds text to the end; note that this should be only used when truly necessary, and the other hatnote templates listed below don't suffice. This template also supports <var>selfref</var>. |
||
− | |||
− | ;{{T|For}}: Provides links to up to four articles or disambiguation pages. It accepts zero to five parameters. |
||
− | |||
− | :;If used without parameters on a page named ''Foo'', the result is |
||
− | ::{{hatnote|For other uses, see [[:Foo (disambiguation)]].}} |
||
− | :;The first parameter changes the hatnote itself and should be plain text, e.g. {{T|For|similar terms}} yields |
||
− | ::{{hatnote|For similar terms, see [[:Foo (disambiguation)]].}} |
||
− | :;The second parameter is used to change the resultant link, e.g. {{T|For|similar terms|Main Page}} yields |
||
− | ::{{For|similar terms|Main Page}} |
||
− | :;The third, fourth and fifth parameters are used to give one, two, or three supplementary links: |
||
− | :*{{For|similar terms|Main Page|Main Page}} |
||
− | :*{{For|similar terms|Main Page|Main Page|Main Page}} |
||
− | :*{{For|similar terms|Main Page|Main Page|Main Page|Main Page}} |
||
− | :the last being produced by e.g. {{T|For|similar terms|Main Page|Main Page|Main Page|Main Page}}. |
||
− | |||
− | == Errors == |
||
− | |||
− | 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. |
||
− | |||
− | Pages that contain this error message are tracked in [[:Category:Hatnote templates with errors]]. |
||
− | |||
− | |||
− | == Technical details == |
||
− | This template uses the [[Help:Lua|Lua templating language]], and more information can be found [[w:c:dev:Global_Lua_Modules/Hatnote|on the Global Lua Module page]]. '''For a traditional wikitext version of this template, see [[w:c:templates:Template:Hatnote|Hatnote on Templates Wiki]]'''. |
||
− | |||
− | The HTML code produced by this template looks like this: |
||
− | |||
− | * <code><nowiki><div role="note" class="hatnote"></nowiki>''hatnote text''<nowiki></div></nowiki></code> |
||
− | |||
⚫ |
Latest revision as of 18:52, 22 July 2019
Description
To use this template, add the {{Item}} template and fill in the appropriate fields. Fields left blank will not appear in articles. This infobox template uses Fandom's infobox syntax.
Syntax
{{Item | title = | image = [e.g. "Example.jpg"] | imagecaption = | type = | effects = | source = | buy = | sell = }}
Sample output
{{Item | title = Power Flower | image = Example.jpg | type = Food | effects = +1 Fire | source = Vendor | buy = 5g | sell = 1g }}