Difference between revisions of "Template:Localized link"

Marked this version for translation
>Shirayuki
m (new tvar syntax)
>Shirayuki
(Marked this version for translation)
Line 25: Line 25:
== Purpose == <!--T:1-->
== Purpose == <!--T:1-->
</translate>
</translate>
<translate>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: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>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: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>
<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.
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.


Line 36: Line 37:


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


Line 61: Line 63:
== Usage in translatable pages == <!--T:6-->
== 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.
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>


# <translate>Should better be substitute this template, and then the wikilink target embedded in a <tvar name=1><code class="mw-highlight">{{^(}}{{#tag:span|tvar|class=nt}} {{attr|name|id}}{{)^}}...{{^(}}/{{#tag:span|tvar|class=nt}}{{)^}}</code></tvar>, separately from the translatable displayed text of the link.</translate>
# <translate><!--T:13--> Should better be substitute this template, and then the wikilink target embedded in a <tvar name=1><code class="mw-highlight">{{^(}}{{#tag:span|tvar|class=nt}} {{attr|name|id}}{{)^}}...{{^(}}/{{#tag:span|tvar|class=nt}}{{)^}}</code></tvar>, separately from the translatable displayed text of the link.</translate>
#: As example, instead <code><nowiki>{{ll|Communication|About communication}}</nowiki></code>, translation markup in translatable page will be <code><nowiki>[[<tvar name=1>Special:MyLanguage/Communication</tvar>|About communication]]</nowiki></code>.
#: As example, instead <code><nowiki>{{ll|Communication|About communication}}</nowiki></code>, translation markup in translatable page will be <code><nowiki>[[<tvar name=1>Special:MyLanguage/Communication</tvar>|About communication]]</nowiki></code>.
# <translate>Alternatively, may be exclude this code from translatable section.</translate>
# <translate><!--T:14--> Alternatively, may be exclude this code from translatable section.</translate>
#: As example, for <code>some text <nowiki>{{ll|Communication|About communication}}</nowiki> some text</code>, translation markup in translatable page will be  
#: As example, for <code>some text <nowiki>{{ll|Communication|About communication}}</nowiki> some text</code>, translation markup in translatable page will be  
#: <code>&lt;translate>some text&lt;/translate> <nowiki>{{ll|Communication|&lt;translate>About communication&lt;/translate>}}</nowiki> &lt;translate>some text&lt;/translate></code>.
#: <code>&lt;translate>some text&lt;/translate> <nowiki>{{ll|Communication|&lt;translate>About communication&lt;/translate>}}</nowiki> &lt;translate>some text&lt;/translate></code>.
#: <translate>This is useful for bulleted lists of links, e.g. in the "See also:" sections.</translate>
#: <translate><!--T:15--> This is useful for bulleted lists of links, e.g. in the "See also:" sections.</translate>
# <translate>If link text does not have to be different from the name of landing page, will be better to embed all this code into <tvar name=1>{{tag|tvar|open}}</tvar>.</translate>
# <translate><!--T:16--> If link text does not have to be different from the name of landing page, will be better to embed all this code into <tvar name=1>{{tag|tvar|open}}</tvar>.</translate>
#: As example, instead {{Tlx|ll|Communication}}, translation markup in translatable page will be <code><nowiki><tvar name=1>{{ll|Communication}}</tvar></nowiki></code>.
#: As example, instead {{Tlx|ll|Communication}}, translation markup in translatable page will be <code><nowiki><tvar name=1>{{ll|Communication}}</tvar></nowiki></code>.


Line 76: Line 79:
== See also == <!--T:7-->
== See also == <!--T:7-->
</translate>
</translate>
* [[Template:Localized link/messagedoc]] — <translate>should be used for message documentation in translatable pages that use this template.</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>alias <tvar name=1>{{tl|TNT}}</tvar> or <tvar name=2>{{tl|tnt}}</tvar></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>alias <tvar name=1>{{tl|TNTN}}</tvar> or <tvar name=2>{{tl|tntn}}</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>alias <tvar name=1>{{tl|pll}}</tvar></translate> - <translate>add a link from a translatable page to another translatable page in the same language</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>


}}
}}
[[Category:Internationalization templates]]
[[Category:Internationalization templates]]
</noinclude>
</noinclude>
Anonymous user