Template:Localized link and Template:Localized link/sandbox: Difference between pages

{{documentation|content=

{{tsh|ll|LL}}

{{High-use|35000}}

<translate>

== Purpose == <!--T:1-->

</translate>

<translate><!--T:8--> This helper template can be used to link to [[<tvar name=1>Special:LanguageStats</tvar>|translatable pages]] in the user's language.</translate>

<translate><!--T:9--> It uses the special page prefix <tvar name=1><code>Special:MyLanguage/</code></tvar>, which checks if there is a translated version of a page in the user's language, and links to it if there is one, and links to a fallback language where available, or the default wiki language version (English in MediaWiki) if there isn't.</translate>

<translate>

<!--T:10-->

It should be used in translated pages, so that they link to the right page even if there is no translated page in that language.

== Usage == <!--T:2-->

</translate>

{{Localized link/doc}}

<translate>

<!--T:11-->

If the "<tvar name=1><code>nsp</code></tvar>" parameter is not defined, as link text this displays the full pagename (including the namespace); otherwise — if the "<tvar name=1><code>nsp</code></tvar>" parameter is defined to any value the link text displays the short pagename (without the namespace).

=== Examples of simple usage === <!--T:3-->

</translate>

{{(}}{{!}} class="wikitable"

{{!}}-

! <translate><!--T:4--> Use</translate>

! <translate><!--T:5--> Becomes</translate>

{{!}}-

{{!}} {{Tlx|ll|Communication}}

{{!}} {{ll|Communication}}

{{!}}-

{{!}} {{Tlx|ll|Communication|コミュニケーション}}

{{!}} {{ll|Communication|コミュニケーション}}

{{!}}-

{{!}} {{Tlx|ll|Project:About}}

{{!}} {{ll|Project:About}}

{{!}}-

{{!}} {{Tlx|ll|Project:About|nsp{{=}}0}}

{{!}} {{ll|Project:About|nsp=0}}

{{!}}{{)}}

<translate>

== Usage in translatable pages == <!--T:6-->

<!--T:12-->

On pages prepared for translation with the <tvar name=1>{{ll|Extension:Translate|nsp=0}}</tvar> extension, this template may be used in three ways.

</translate>

# <translate><!--T:13--> Substitute this template, then embed the wikilink target in a <tvar name=1>{{#tag:syntaxhighlight|{{^(}}tvar name=id{{)^}}...{{^(}}/tvar{{)^}}|lang=html|inline=1}}</tvar>, separate from the translatable text of the link.</translate>

#: <translate><!--T:22--> For example, instead of <tvar name=1><code><nowiki>{{ll|Communication|About communication}}</nowiki></code></tvar>, the translation markup in the translatable page will be <tvar name=2>{{#tag:syntaxhighlight|[[{{^(}}tvar name=1{{)^}}Special:MyLanguage/Communication{{^(}}/tvar{{)^}}|About communication]]|lang=html|inline=1}}</tvar>.</translate>

# <translate><!--T:14--> Alternatively, exclude this code from the translatable section.</translate>

#: <translate><!--T:23--> For example, for <tvar name=1><code>some text <nowiki>{{ll|Communication|About communication}}</nowiki> some text</code></tvar>, the translation markup in the translatable page will be:</translate>

#: {{#tag:syntaxhighlight|{{^(}}translate{{)^}}some text{{^(}}/translate{{)^}} {{((}}ll{{!}}Communication{{!}}2={{^(}}translate{{)^}}About communication{{^(}}/translate{{)^}}{{))}} {{^(}}translate{{)^}}some text{{^(}}/translate{{)^}}|lang=html|inline=1}}

#: <translate><!--T:15--> This is useful for bulleted lists of links, e.g. in the "See also:" sections.</translate>

# <translate><!--T:16--> If link text is the same as the name of the target page, all of the code could also be embedded into <tvar name=1>{{tag|tvar|open}}</tvar>.</translate>

#: <translate><!--T:24--> For example, instead of <tvar name=1>{{Tlx|ll|Communication}}</tvar>, the wikicode in the translatable page will be <tvar name=2>{{#tag:syntaxhighlight|{{^(}}tvar name=1{{)^}}{{((}}ll{{!}}Communication{{))}}{{^(}}/tvar{{)^}}|lang=html|inline=1}}</tvar>.</translate>

== Test cases ==

{{Localized link/testcases}}

<translate>

== See also == <!--T:7-->

</translate>

* [[Template:Localized link/messagedoc]] — <translate><!--T:17--> should be used for message documentation in translatable pages that use this template.</translate>

* {{tl|Translatable template}} - <translate><!--T:18--> alias <tvar name=1>{{tl|TNT}}</tvar> or <tvar name=2>{{tl|tnt}}</tvar></translate>

* {{tl|Translatable template name}} - <translate><!--T:19--> alias <tvar name=1>{{tl|TNTN}}</tvar> or <tvar name=2>{{tl|tntn}}</tvar></translate>

* {{tl|Page language link}} - <translate><!--T:20--> alias <tvar name=1>{{tl|pll}}</tvar></translate> - <translate><!--T:21--> add a link from a translatable page to another translatable page in the same language</translate>

}}