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><translate>some text</translate> <nowiki>{{ll|Communication|<translate>About communication</translate>}}</nowiki> <translate>some text</translate></code>. | #: <code><translate>some text</translate> <nowiki>{{ll|Communication|<translate>About communication</translate>}}</nowiki> <translate>some text</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> | ||