Editing Template:Distinguish/doc (section)

== 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 &#91;&#91;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)&#123;&#123;&#33;&#125;&#125;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}}