Difference between revisions of "Template:Hatnote templates documentation"

From unroole CMS wiki
Jump to: navigation, search
m (1 revision)
(Replaced content with "{{Documentation subpage}}<!-- Note this is a documentation page to cover all hatnote templates. --> {{See also| [http://en.wikipedia.org/wiki/Template:Hatnote_templates_...")
Line 1: Line 1:
 
{{Documentation subpage}}<!-- Note this is a documentation page to cover all hatnote templates.  
 
{{Documentation subpage}}<!-- Note this is a documentation page to cover all hatnote templates.  
--><div style="float:right; padding: 0 1em;">{{navbar|Hatnote templates documentation|text=This general documentation}}</div>
+
-->
==Hatnote templates==
+
{{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===
+
{{See also| [http://en.wikipedia.org/wiki/Template:Hatnote_templates_documentation Wiki doc] }}
* {{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}} is used to make [[wikipedia:summary style|summary style]] explicit. To be used in a section for which there is also a separate article on the subject.
+
* {{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|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]]}}
+
 
+
===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|Main Article}} → {{Main|Main Article}}
+
* {{tlx|Main|Main Article|Article2}} → {{Main|Main Article|Article2}}
+
* {{tlx|Main list|Article1}} → {{Mainlist|Article1}}
+
* {{tlx|ArticlePreceeding|George Washington}} → {{ArticlePreceeding|George Washington}}
+
* {{tlx|ArticleSucceeding|Thomas Jefferson}} → {{ArticleSucceeding|Thomas Jefferson}}
+
* {{tlx|ArticlePair|George Washington|Thomas Jefferson}} → {{ArticlePair|George Washington|Thomas Jefferson}}
+
 
+
===Wikipedia self-reference===
+
* {{tlx|Selfref|ANYTEXT}} → {{Selfref|ANYTEXT}}
+
:See: [[Wikipedia:Manual of Style (self-references to avoid)|Manual of Style (self-references to avoid)]] for more details.
+
 
+
===Categories===
+
Category-specific templates produce bold category names.
+
* {{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|CatPreceding|OTHER TOPIC}} → {{CatPreceding|OTHER TOPIC}}
+
* {{tlx|CatSucceeding|OTHER TOPIC}} → {{CatSucceeding|OTHER TOPIC}}
+
* {{tlx|Category pair|TOPIC1|TOPIC2}} → {{Category pair|TOPIC1|TOPIC2}}
+
* {{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===
+
* [[WP:Hatnote]]
+
* {{tl|hatnote templates documentation}} (generic)
+
* [[:Category: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>
+

Revision as of 15:51, 16 May 2012