Template:Distinguish/doc - Revision history

Orangestar: Text replacement - "Help:Magic words" to "wikipedia:Help:Magic words"

2024-06-13T18:05:11Z

Text replacement - "Help:Magic words" to "wikipedia:Help:Magic words"

← Older revision		Revision as of 18:05, 13 June 2024
Line 23:		Line 23:
	Note that a final period is automatically added at the end of the sentence, and that only one blue link is used per disambiguated topic (i.e, do not type <code><nowiki>...an [[epithet]] of the [[Greek]] god [[Apollo]].</nowiki></code>		Note that a final period is automatically added at the end of the sentence, and that only one blue link is used per disambiguated topic (i.e, do not type <code><nowiki>...an [[epithet]] of the [[Greek]] god [[Apollo]].</nowiki></code>

	When the target is a disambiguation page, display of the parentheses may be avoided by escaping the vertical bar using the [[Help:Magic words\|magic word]] {{Tl\|!}}:		When the target is a disambiguation page, display of the parentheses may be avoided by escaping the vertical bar using the [[wikipedia:Help:Magic words\|magic word]] {{Tl\|!}}:
	{{Tick}}{{tlx\|distinguish\|Crossfire (disambiguation){{!}}Crossfire}} → {{Distinguish\|Crossfire (disambiguation){{!}}Crossfire}}		{{Tick}}{{tlx\|distinguish\|Crossfire (disambiguation){{!}}Crossfire}} → {{Distinguish\|Crossfire (disambiguation){{!}}Crossfire}}
	The escape is necessary, otherwise the template will read the next text as another topic:		The escape is necessary, otherwise the template will read the next text as another topic:

Orangestar: Text replacement - "[[WP:" to "[[wikipedia:WP:"

2024-06-13T17:53:22Z

Text replacement - "[[WP:" to "[[wikipedia:WP:"

← Older revision		Revision as of 17:53, 13 June 2024
Line 6:		Line 6:

	== Description ==		== Description ==
	The "distinguish" template produces a [[WP:HAT\|hatnote]] to point out to our readers the existence of one or more articles whose title(s) is, or are, similar to the page in question. It is used in cases where the distinction between the titles is generally obvious and does not need further explanation.		The "distinguish" template produces a [[wikipedia:WP:HAT\|hatnote]] to point out to our readers the existence of one or more articles whose title(s) is, or are, similar to the page in question. It is used in cases where the distinction between the titles is generally obvious and does not need further explanation.

	For those cases where an explanation is required, please use the templates {{tl\|For}} and {{tl\|About}}. For use on category pages, the corresponding template is {{Tl\|Category distinguish}}.		For those cases where an explanation is required, please use the templates {{tl\|For}} and {{tl\|About}}. For use on category pages, the corresponding template is {{Tl\|Category distinguish}}.
Line 18:		Line 18:
	{{tlx\|distinguish\|Bangla language\|Mbangala language\|Ngala language}} → {{Distinguish\|Bangla language\|Mbangala language\|Ngala language}}		{{tlx\|distinguish\|Bangla language\|Mbangala language\|Ngala language}} → {{Distinguish\|Bangla language\|Mbangala language\|Ngala language}}

	The {{para\|text}} parameter can be used to create customized text, in case context is required. An example is on the article [[Phobos (mythology)]], which contains a customized hatnote to distinguish it and "[[Phoebus]]" (a redirect of [[Apollo]]). Both links lead to topics about Greek gods, so the [[WP:NCDAB\|parenthetical disambiguation]] in "Phobos (mythology)" is insufficient to disambiguate the two. Since it [[WP:HNR\|is typically not preferable to link a redirect]] in a hatnote, the article "Apollo" is linked to directly and a short explanation fills in the necessary context:		The {{para\|text}} parameter can be used to create customized text, in case context is required. An example is on the article [[Phobos (mythology)]], which contains a customized hatnote to distinguish it and "[[Phoebus]]" (a redirect of [[Apollo]]). Both links lead to topics about Greek gods, so the [[wikipedia:WP:NCDAB\|parenthetical disambiguation]] in "Phobos (mythology)" is insufficient to disambiguate the two. Since it [[wikipedia:WP:HNR\|is typically not preferable to link a redirect]] in a hatnote, the article "Apollo" is linked to directly and a short explanation fills in the necessary context:
	{{tlx\|distinguish\|text {{=}} Phoebus, an epithet of the Greek god [[Apollo]]}} → {{Distinguish\|text = Phoebus, an epithet of the Greek god [[Apollo]] }}		{{tlx\|distinguish\|text {{=}} Phoebus, an epithet of the Greek god [[Apollo]]}} → {{Distinguish\|text = Phoebus, an epithet of the Greek god [[Apollo]] }}

Line 45:		Line 45:
	:: ''This article is about the board game. For the card game, see [[Reversis]].''		:: ''This article is about the board game. For the card game, see [[Reversis]].''

	{{tlc\|Distinguish}} should only be used when the ambiguity exists for a portion of the readership that is sufficient to warrant a hatnote. Care should be taken to [[WP:TRHAT\|avoid trivial uses]].		{{tlc\|Distinguish}} should only be used when the ambiguity exists for a portion of the readership that is sufficient to warrant a hatnote. Care should be taken to [[wikipedia:WP:TRHAT\|avoid trivial uses]].

	== TemplateData ==		== TemplateData ==

Orangestar: 1 revision imported

2024-06-09T22:08:57Z

1 revision imported

← Older revision		Revision as of 22:08, 9 June 2024
(No difference)

en>Belbury: replace confusing theoretical "Foo" example with some real, in-use ones

2024-02-13T10:22:37Z

replace confusing theoretical "Foo" example with some real, in-use ones

New page

{{Documentation subpage}}
{{tsh|dist|ntbcw|confuse}}

{{High-use| 65005 }}
{{Lua|Module:distinguish}}

== Description ==
The "distinguish" template produces a [[WP:HAT|hatnote]] to point out to our readers the existence of one or more articles whose title(s) is, or are, similar to the page in question. It is used in cases where the distinction between the titles is generally obvious and does not need further explanation.

For those cases where an explanation is required, please use the templates {{tl|For}} and {{tl|About}}. For use on category pages, the corresponding template is {{Tl|Category distinguish}}.

== Usage ==
Here is an example of its standard usage on the article about the mathematical [[Astroid]]:
{{tlx|distinguish|Asteroid}} → {{Distinguish|Asteroid}}

This hatnote can be used to distinguish the topic from multiple other topics, as for [[Corundum]] or [[Bangala language]]:
{{tlx|distinguish|Carborundum|Conundrum}} → {{Distinguish|Carborundum|Conundrum}}
{{tlx|distinguish|Bangla language|Mbangala language|Ngala language}} → {{Distinguish|Bangla language|Mbangala language|Ngala language}}

The {{para|text}} parameter can be used to create customized text, in case context is required. An example is on the article [[Phobos (mythology)]], which contains a customized hatnote to distinguish it and "[[Phoebus]]" (a redirect of [[Apollo]]). Both links lead to topics about Greek gods, so the [[WP:NCDAB|parenthetical disambiguation]] in "Phobos (mythology)" is insufficient to disambiguate the two. Since it [[WP:HNR|is typically not preferable to link a redirect]] in a hatnote, the article "Apollo" is linked to directly and a short explanation fills in the necessary context:
{{tlx|distinguish|text {{=}} Phoebus, an epithet of the Greek god [[Apollo]]}} → {{Distinguish|text = Phoebus, an epithet of the Greek god [[Apollo]] }}

Note that a final period is automatically added at the end of the sentence, and that only one blue link is used per disambiguated topic (i.e, do not type <code><nowiki>...an [[epithet]] of the [[Greek]] god [[Apollo]].</nowiki></code>

When the target is a disambiguation page, display of the parentheses may be avoided by escaping the vertical bar using the [[Help:Magic words|magic word]] {{Tl|!}}:
{{Tick}}{{tlx|distinguish|Crossfire (disambiguation){{!}}Crossfire}} → {{Distinguish|Crossfire (disambiguation){{!}}Crossfire}}
The escape is necessary, otherwise the template will read the next text as another topic:
{{Cross}}{{tlx|distinguish|Crossfire (disambiguation)|Crossfire}} → {{Distinguish|Crossfire (disambiguation)|Crossfire}}

== When to use ==
This hatnote is generally used when readers have misspelled their desired title, and the error would be apparent by simply displaying the alternative term without further explanation. For example, consider a reader looking for the punctuation mark who instead ends up at [[coma]]:
: [[Coma]]
: {{Distinguish|Comma}}

Readers are presumed to recognize that they actually wanted ''comma'' by merely looking at the spelling, and this case generally requires no further explanation.

However, {{tlx|distinguish}} is not suitable when the difference is not readily apparent without additional details. Consider a reader looking for a game they believe is named Reversi:
: {{cross}} [[Reversi]]
: {{Distinguish|Reversis}}

In the above hatnote, it is not generally apparent how the suggested Reversis is different from Reversi, which is also a game.

In this case you should use {{tlx|about}} instead of {{tlc|distinguish}}. The difference is to provide explanation upfront without requiring the reader to click through and differentiate the terms on their own.
: {{tick}} [[Reversi]]
:: ''This article is about the board game. For the card game, see [[Reversis]].''

{{tlc|Distinguish}} should only be used when the ambiguity exists for a portion of the readership that is sufficient to warrant a hatnote. Care should be taken to [[WP:TRHAT|avoid trivial uses]].

== TemplateData ==
{{TemplateData header}}
<templatedata>
{
"params": {
"1": {
"label": "Name of article",
"description": "Name of article that you want to link to",
"type": "wiki-page-name",
"suggested": true
},
"2": {
"label": "Optional additional article to link (2)",
"description": "Optional additional article to link",
"type": "wiki-page-name"
},
"3": {
"label": "Optional additional article to link (3)",
"description": "Optional additional article to link",
"type": "wiki-page-name"
},
"4": {
"label": "Optional additional article to link (4)",
"description": "Optional additional article to link",
"type": "wiki-page-name"
},
"text": {
"label": "Custom text",
"description": "Custom message in wikitext; e.g. \"[[foo]] and [[Bar (computer science)|bar]]\" produces \"Not to be confused with [[foo]] and [[Bar (computer science)|bar]].\"",
"type": "string"
},
"selfref": {
"label": "Self reference",
"description": "If set, marks note as being a self reference, to not be shown when content is reused",
"type": "boolean"
}

},
"description": "A hatnote used when there is an ambiguity in an article's title.",
"paramOrder": [
"1",
"2",
"3",
"4",
"text",
"selfref"
],
"format": "inline"
}
</templatedata>

== Redirects ==
* {{tl|Confused}}
* {{tl|Confuse}}
* {{tl|Misspelling}}
* {{tl|Nottobeconfusedwith}}
* {{tl|Ntbcw}}

== See also ==
* {{tl|About}}
* {{tl|Category distinguish}}
* {{tl|For}}
* {{tl|Redirect}}
* {{tl|R from misspelling}}

{{Hatnote templates}}

<includeonly>{{sandbox other||

[[Category:Disambiguation and redirection templates]]
[[Category:Hatnote templates]]
}}</includeonly>