Editing Template:Hatnote templates documentation (section)

==Hatnote templates==
<div style="float:right; padding: 0 1em;">{{navbar|Hatnote templates documentation|text=This general documentation}}</div>
{{Shortcut|T:HAT}}
For a summary page on how to use these templates, see [[Wikipedia:HATTEST|the example page here]]. For the full editing guideline on hatnotes, see [[Wikipedia:Hatnote]].

===Generic===
* {{tlx|Hatnote|CUSTOM TEXT}} → {{Hatnote|CUSTOM TEXT}}
:{{tlx|Hatnote|For other senses of this term, see <nowiki>[[</nowiki>etc…<nowiki>]]</nowiki>}} &rarr; {{Hatnote|For other senses of this term, see [[etc…]]}}
* {{tlx|Rellink|CUSTOM TEXT}} → {{Rellink|CUSTOM TEXT}}

===Other uses (of the title)===
===="''This page is about … For other uses …''"====
{{tl|About}} is the main template for noting other uses.

''Note. When used in [[Wikipedia:Main namespace|main namespace]], the word "page" in the following hatnotes is replaced by "article".''

* {{tlx|About|USE1}} → {{About|USE1}}
* {{tlx|About|USE1<nowiki>||</nowiki>PAGE2}} (When the disambiguation page has a different name – Note the empty second parameter) → {{About|USE1||PAGE2}}
* {{tlx|About|USE1|USE2|PAGE2}} (When there is only one other use) → {{About|USE1|USE2|PAGE2}}
* {{tlx|About|USE1|USE2|PAGE2|and|PAGE3}} (Two pages for USE2) → {{About|USE1|USE2|PAGE2|and|PAGE3}}
* {{tlx|About|USE1|USE2|PAGE2#SUBSECTION{{tlf|!}}PAGE2TITLE}} (Using the {{tl|!}} template to give the link a different title) &rarr; {{About|USE1|USE2|PAGE2#SUBSECTION{{!}}PAGE2TITLE}}
* {{tlx|About|USE1|USE2|PAGE2|USE3|PAGE3|USE4|PAGE4|USE5|PAGE5}} (When there are up to four other uses – You should generally create a [[Wikipedia:Disambiguation|disambiguation page]] at this point) → {{About|USE1|USE2|PAGE2|USE3|PAGE3|USE4|PAGE4|USE5|PAGE5}}
* {{tlx|About|USE1|USE2|PAGE2|USE3|PAGE3|other uses}} (When there are several standard other uses and also a disambiguation page with default name – Note that the last page name is not specified) → {{About|USE1|USE2|PAGE2|USE3|PAGE3|other uses}} 
* {{tlx|About|USE1|USE2|PAGE2|USE3|PAGE3|other uses|PAGE4}} (When there are several standard other uses and also a disambiguation page with non-default name) →{{About|USE1|USE2|PAGE2|USE3|PAGE3|other uses|PAGE4}}
* {{tlx|About|USE1|USE2|PAGE2|USE3|PAGE3|other uses|PAGE4|and}} → {{About|USE1|USE2|PAGE2|USE3|PAGE3|other uses|PAGE4|and}} 
* {{tlx|About|<nowiki>|</nowiki>USE2|PAGE2|USE3|PAGE3|other uses}} (When you don't need to state the focus of this article/page – Note the empty first parameter) → {{About||USE2|PAGE2|USE3|PAGE3|other uses}}
* {{tlx|About|<nowiki>||</nowiki>PAGE1|and|PAGE2}} → {{About|||PAGE1|and|PAGE2|_nocat=1}}
:Note: {{tlx|for|<nowiki>|</nowiki>PAGE1|PAGE2}} produces the same result.
* {{tlx|Other uses-section|USE}} (disambiguous) → {{Other uses-section|USE}}
:Note: this hatnote says "section", instead of "article" or "page".

===="''See also …''"====
* {{tlx|See also|OTHER TOPIC|OTHER TOPIC2}} → {{See also|OTHER TOPIC|OTHER TOPIC2}}
:Note: use when OTHER TOPIC is related to that of the current article and already contains a self-explanatory parenthetical.

* {{tlx|See also2|<nowiki>[[OTHER TOPIC]]|[[OTHER TOPIC2]]|[[OTHER TOPIC3]] and other text</nowiki>}} → {{See also2|[[OTHER TOPIC]]|[[OTHER TOPIC2]]|[[OTHER TOPIC3]] and other text}}

===="''For …, see …''"====
{{tl|For}} can be used instead of {{tl|About}} so as not to display: ''This page is about USE1.'' but still specify a specific other use. This effect can also be achieved by using an empty first parameter in {{tl|About}} as in:

:''For example'': {{tlx|for|OTHER TOPIC|PAGE1}} is the same as {{tlx|About|<nowiki>|</nowiki>OTHER TOPIC|PAGE1}} (note the empty first parameter).<br>
However, it is somewhat clearer when using the {{tl|For}} template, since the word "about" does not appear in the statement.

* {{tlx|For|OTHER TOPIC}} (disambiguous) → {{For|OTHER TOPIC}}
* {{tlx|For|OTHER TOPIC|PAGE1}} → {{For|OTHER TOPIC|PAGE1}}
* {{tlx|For|OTHER TOPIC|PAGE1|PAGE2}} → {{For|OTHER TOPIC|PAGE1|PAGE2}}
* {{tlx|For|OTHER TOPIC|PAGE1|PAGE2|PAGE3}} → {{For|OTHER TOPIC|PAGE1|PAGE2|PAGE3}}
* {{tlx|For|<nowiki>|</nowiki>PAGE1|PAGE2}} → {{For||PAGE1|PAGE2}}

;Variations
As with {{tl|Other uses}}, there are a whole family of "for" templates.
* {{tlx|For2|OTHER TOPIC|CUSTOM TEXT}} → {{For2|OTHER TOPIC|CUSTOM TEXT}}

===="''For other uses, see …''"====
When such a wordy hatnote as {{tl|About}} is not needed, {{tl|Other uses}} is often useful.

* {{tlx|Other uses}} (disambiguous) → {{Other uses}}
* {{tlx|Other uses|PAGE1}} → {{Other uses|PAGE1}}
* {{tlx|Other uses|PAGE1|PAGE2}} → {{Other uses|PAGE1|PAGE2}}

;Variations
There are, historically, a whole family of "other uses" templates for specific cases. {{tl|About}} is the standard hatnote for "other uses" and many of them can be specified using the {{tl|About}} template. However, the individual templates may be easier to use in certain contexts.

Here are the variations and (when appropriate) the equivalents using the {{tl|About}}, {{tl|Other uses}} or {{tl|For}} templates.
* {{tlx|Other uses2|PAGE1}} (disambiguous) → {{Other uses2|PAGE1}}
:Note: adds "(disambiguation)" to whatever is input as the PAGE1.
:Note: {{tlx|Other uses|PAGE1 (disambiguation)}} produces the same result.
* {{tlx|Two other uses|USE1|USE2|PAGE2}} → {{Two other uses|USE1|USE2|PAGE2}}
:Note: same as {{tl|about}}, except it forces a second use to be noted if unspecified by parameters.
* {{tlx|Two other uses|USE1|USE2|PAGE2|USE3|PAGE3}} → {{Two other uses|USE1|USE2|PAGE2|USE3|PAGE3}}
* {{tlx|Three other uses|USE1|USE2|PAGE2|USE3|PAGE3}} {{Three other uses|USE1|USE2|PAGE2|USE3|PAGE3}}
* {{tlx|Three other uses|<nowiki>|</nowiki>USE2|PAGE2|USE3|PAGE3}} → {{Three other uses||USE2|PAGE2|USE3|PAGE3}}
* {{tlx|Three other uses|USE1|USE2|PAGE2|USE3|PAGE3|USE4|PAGE4}} → {{Three other uses|USE1|USE2|PAGE2|USE3|PAGE3|USE4|PAGE4}}

===="''For other uses of …, see …''"====
* {{tlx|Other uses of}} (disambiguous) → {{Other uses of}}
* {{tlx|Other uses of|TOPIC}} (disambiguous) → {{Other uses of|TOPIC}}
* {{tlx|Other uses of|TOPIC|PAGE1}} → {{Other uses of|TOPIC|PAGE1}}

===="''For more details on …, see …''"====
{{tlx|Details}} can supplement {{tlx|Main}} in summary sections, or can indicate more details in nonsummary sections:
* {{tlx|Details|Article|TOPIC}} → {{Details|Article|TOPIC}}

{{tl|Details3}} allows any text to links:
* {{tlx|Details3|<nowiki>[[article 1]], [[article 2]], and [[article 3]]</nowiki>|TOPIC}} → {{Details3|[[article 1]], [[article 2]], and [[article 3]]|TOPIC}}

===="''… redirects here. For other uses, see …''"====
* {{tlx|Redirect|REDIRECT}} (disambiguous) → {{Redirect|REDIRECT}}
* {{tlx|Redirect|REDIRECT<nowiki>||</nowiki>PAGE1}} → {{Redirect|REDIRECT||PAGE1}}
* {{tlx|Redirect|REDIRECT|USE1|PAGE1}} → {{Redirect|REDIRECT|USE1|PAGE1}}
* {{tlx|Redirect|REDIRECT|USE1|PAGE1|USE2|PAGE2}} → {{Redirect|REDIRECT|USE1|PAGE1|USE2|PAGE2}}
* {{tlx|Redirect|REDIRECT|USE1|PAGE1|USE2|PAGE2|USE3|PAGE3}} → {{Redirect|REDIRECT|USE1|PAGE1|USE2|PAGE2|USE3|PAGE3}}
* {{tlx|Redirect|REDIRECT|USE1|PAGE1|and|PAGE2}} → {{Redirect|REDIRECT|USE1|PAGE1|and|PAGE2}}
* {{tlx|Redirect|REDIRECT|USE1|PAGE1|USE2|PAGE2|and|PAGE3}} → {{Redirect|REDIRECT|USE1|PAGE1|USE2|PAGE2|and|PAGE3}}

;Variations
* {{tlx|Redirect-synonym|TERM|OTHER TOPIC}} → {{Redirect-synonym|TERM|OTHER TOPIC}}
* {{tlx|Redirect2|REDIRECT1|REDIRECT2}} (disambiguous) → {{Redirect2|REDIRECT1|REDIRECT2}}
* {{tlx|Redirect2|REDIRECT1|REDIRECT2|USE|PAGE1}} → {{Redirect2|REDIRECT1|REDIRECT2|USE|PAGE1}}
* {{tlx|Redirect2|REDIRECT1|REDIRECT2|USE1|PAGE1|USE2|PAGE2}} → {{Redirect2|REDIRECT1|REDIRECT2|USE1|PAGE1|USE2|PAGE2}}
* {{tlx|Redirect2|REDIRECT1|REDIRECT2|USE1|PAGE1|USE2|PAGE2|USE3|PAGE3}} → {{Redirect2|REDIRECT1|REDIRECT2|USE1|PAGE1|USE2|PAGE2|USE3|PAGE3}}
* {{tlx|Redirect2|REDIRECT1|REDIRECT2|USE1|PAGE1|USE2|PAGE2|USE3|PAGE3|USE4|PAGE4}} → {{Redirect2|REDIRECT1|REDIRECT2|USE1|PAGE1|USE2|PAGE2|USE3|PAGE3|USE4|PAGE4}}
* {{tlx|Redirect3|REDIRECT|TEXT}} → {{Redirect3|REDIRECT|TEXT}}
* {{tlx|Redirect4|REDIRECT1|REDIRECT2}} (disambiguous) → {{Redirect4|REDIRECT1|REDIRECT2}}
* {{tlx|Redirect6|REDIRECT|USE1|PAGE1}} (disambiguous) → {{Redirect6|REDIRECT|USE1|PAGE1}}
* {{tlx|Redirect6|REDIRECT|USE1|PAGE1|‌|PAGE2}} → {{Redirect6|REDIRECT|USE1|PAGE1||PAGE2}}
* {{tlx|Redirect7|"REDIRECT1", "REDIRECT2", and "REDIRECT3"|USE1|PAGE1|USE2|PAGE2}} → {{Redirect7|"REDIRECT1", "REDIRECT2", and "REDIRECT3"|USE1|PAGE1|USE2|PAGE2}}
:Note: If the number of pages redirecting to the target page is two, {{tlx|Redirect2}} can be used instead. If the number is three and there are three corresponding disambiguation pages, {{tlx|Redirect10}} can be used.
* {{tlx|Redirect10|REDIRECT1|REDIRECT2|REDIRECT3}} (disambiguous) → {{Redirect10|REDIRECT1|REDIRECT2|REDIRECT3}}
;''... Not to be confused with ...''
* {{tlx|Redirect-distinguish|REDIRECT|PAGE1}} → {{Redirect-distinguish|REDIRECT|PAGE1}}
* {{tlx|Redirect-distinguish|REDIRECT|PAGE1|PAGE2|PAGE3|PAGE4}} → {{Redirect-distinguish|REDIRECT|PAGE1|PAGE2|PAGE3|PAGE4}}
* {{tlx|Redirect-distinguish2|REDIRECT|TEXT}} → {{Redirect-distinguish2|REDIRECT|TEXT}}

===="''Further information: …''"====
* {{tlx|Further|PAGE}} → {{Further|PAGE}}
* {{tlx|Further|PAGE1|PAGE2|PAGE3}} &rarr; {{Further|PAGE1|PAGE2|PAGE3}}
* {{tlx|Further2|<nowiki>[[Article 1]], [[Article 2]], and [[Article Something#3|Article 3]]</nowiki>}} → {{Further2|[[Article 1]], [[Article 2]], and [[Article Something#3|Article 3]]}}

===="''… If you are seeking another topic, … consider adding it to ….''"====
* {{tlx|Consider disambiguation|USE1|USE2|PAGE2}} (disambiguous) → {{Consider disambiguation|USE1|USE2|PAGE2}} 
* {{tlx|Consider disambiguation|USE1|USE2|PAGE2|PAGE3}} → {{Consider disambiguation|USE1|USE2|PAGE2|PAGE3}}
:Note:USE1 can be omitted, resulting in language like {{tl|For}} above.

===Other people, places, etcetera===
====Other people====
* {{tlx|Other people}} (disambiguous) → {{Other people}}
* {{tlx|Other people|NAME}} (disambiguous) → {{Other people|NAME}}
* {{tlx|Other people|NAME|PAGE}} → {{Other people|NAME|PAGE}}
* {{tlx|Other people|NAME|PAGE|named{{=}}titled}} → {{Other people|NAME|PAGE|named=titled}}
* {{tlx|Other people2|PAGE}} → {{Other people2|PAGE}}
* {{tlx|Other people3}} (disambiguous) → {{Other people3}}
:Note: same as {{tl|About}} except uses "other people" instead of "other uses" if only 1 parameter is used
* {{tlx|Other people3|PERSON1}} (disambiguous) → {{Other people3|PERSON1}}
* {{tlx|Other people3|PERSON1|PERSON2}} (disambiguous) → {{Other people3|PERSON1|PERSON2}}
* {{tlx|Other people3|PERSON1|PERSON2|PAGE2}} → {{Other people3|PERSON1|PERSON2|PAGE2}}
* {{tlx|Other people3|PERSON1<nowiki>||</nowiki>PAGE2}} → {{Other people3|PERSON1||PAGE2}}
* {{tlx|Other people5|NAME1|NAME2|NAME3|NAME4}} → {{Other people5|NAME1|NAME2|NAME3|NAME4}}
:Note: defaults to "named" as in {{tl|Other people}}, exists for options like "nicknamed", "known as", etc.

====Other places====
* {{tlx|Other places}}, analogous to {{tl|Other uses}} (disambiguous) → {{Other places}}
* {{tlx|Other places|PAGE}}, analogous to {{tl|Other uses2}}(disambiguous) → {{Other places|PAGE}}
* {{tlx|Other places3|PAGE}}, analogous to {{tl|Other uses}} → {{Other places3|PAGE}}

====Other hurricanes====
For articles on storms:
* {{tlx|Other hurricanes}} (disambiguous) → {{Other hurricanes}}
* {{tlx|Other hurricanes|PAGE1}} → {{Other hurricanes|PAGE1}}
* {{tlx|Other hurricanes|PAGE1|THIS}} → {{Other hurricanes|PAGE1|THIS}}
* {{tlx|Other hurricanes|<nowiki>|</nowiki>THIS}} → {{Other hurricanes||THIS}}

====Other ships====
For articles on ships:
* {{tlx|Other ships|SHIP1}} → {{Other ships|SHIP1}}

===Distinguish===
===="''Not to be confused with …''"====
* {{tlx|Distinguish|PAGE1}} → {{Distinguish|PAGE1}}
* {{tlx|Distinguish|PAGE1|PAGE2|PAGE3|PAGE4}} → {{Distinguish|PAGE1|PAGE2|PAGE3|PAGE4}}
* {{tlx|Distinguish2|TEXT}} → {{Distinguish2|TEXT}}

===="''… redirects here. It is not to be confused with …''"====
* {{tlx|Redirect-distinguish|REDIRECT|PAGE1}} → {{Redirect-distinguish|REDIRECT|PAGE1}}
* {{tlx|Redirect-distinguish|REDIRECT|PAGE1|PAGE2|PAGE3|PAGE4}} → {{Redirect-distinguish|REDIRECT|PAGE1|PAGE2|PAGE3|PAGE4}}
* {{tlx|Redirect-distinguish2|REDIRECT|TEXT}} → {{Redirect-distinguish2|REDIRECT|TEXT}}

==="''Main article: …''" etc.===
{{tlx|Main}} is used to make [[Wikipedia:Summary style|summary style]] explicit, when used in a summary section for which there is also a separate article on the subject:
* {{tlx|Main|Main Article}} → {{Main|Main Article}} 
* {{tlx|Main|Main Article|Article2}} → {{Main|Main Article|Article2}} 
* {{tlx|Main list|Article1}} → {{Mainlist|Article1}} 
* {{tlx|Cat main|MAIN ARTICLE}}  → {{Cat main|MAIN ARTICLE}}

===Wikipedia self-reference===
* {{tlx|Selfref|ANYTEXT}} → {{Selfref|ANYTEXT}}
{{see|Wikipedia:Manual of Style/Self-references to avoid}}

===Categories===
Category-specific templates:
* {{tlx|Category see also|THIS|THAT|THE OTHER}} → {{Category see also|THIS|THAT|THE OTHER}}
This is a template for linking categories ''horizontally''. Horizontal linkage is often the right solution when ''vertical linkage'' (i.e., as sub-category and parent category) is not appropriate. 
In most cases, this template should be used on ''both'' categories to create ''reciprocal linkage'' between the two categories.

* {{tlx|Cat main|MAIN ARTICLE}} → {{Cat main|MAIN ARTICLE}}
* {{tlx|Category explanation|colourless green ideas}} → {{Category explanation|colourless green ideas}}
* {{tlx|Category pair|TOPIC1|TOPIC2}} → {{Category pair|TOPIC1|TOPIC2}}
* {{tlx|CatPreceding|OTHER TOPIC}} → {{CatPreceding|OTHER TOPIC}}
* {{tlx|CatSucceeding|OTHER TOPIC}} → {{CatSucceeding|OTHER TOPIC}}
* {{tlx|Contrast|OTHERCAT|OTHERCAT2}} → {{Contrast|OTHERCAT|OTHERCAT2}}
* {{tlx|Contrast|OTHERCAT|OTHERCAT2|plural{{=}}yes}} → {{Contrast|OTHERCAT|OTHERCAT2|plural=yes}}

===Family names===
{{see|:Category:Hatnote templates for names}}
===Lists===
{{see|:Category:Hatnote templates for lists}}
===User pages===
* {{tlx|This user talk|TOPIC|PAGE1}} →<br/>
{{This user talk|TOPIC|PAGE1}}

===Notes===
'''Do not use [[Wikipedia:Substitution|subst:]] with these templates''', as that will prevent: 
# propagating changes as the template is modified; and the
# ''[[Special:Whatlinkshere/{{NAMESPACE}}:{{PAGENAME}}|What links here]]'' (WLH) listing.

These templates are used in thousands of articles; therefore, changing the syntax could break thousands of articles. If you wish to create or edit a disambiguation or redirection template, first ask yourself the following questions:
# Is there already a template that will do this job? Since many disambiguation and redirection templates have already been created, first check: [[:Category:Disambiguation and redirection templates]].
# Do I really need a new template for this? Will it likely be used on any other articles or should I just use {{tl|Hatnote}} instead? Before creating a new template, see the [[Wikipedia:Template namespace|template namespace]] guideline.
# If I change the parameters around on an existing template, do I know what the result will be? Will it break existing uses of the template and if so, can I fix all of the errors? Before making any changes, see [[Wikipedia:Template sandbox and test cases|Template sandbox and test cases]].

===See also===
*[[Wikipedia:Hatnote]]
*{{cl|Hatnote templates}}

{{Navbox hatnote templates|state=collapsed}}<noinclude>

{{Documentation}} <!-- so this is for the /doc page of this documentation-template -->

[[Category:Hatnote templates documentation|Documentation]]

</noinclude>