Difference between revisions of "Template:Localized link"
prepare for translation
>Shirayuki (Marked this version for translation) |
>Shirayuki (prepare for translation) |
||
| Line 25: | Line 25: | ||
== Purpose == <!--T:1--> | == Purpose == <!--T:1--> | ||
</translate> | </translate> | ||
This helper template can be used to link to [[Special:LanguageStats|translatable pages]] in the user's language. | <translate>This helper template can be used to link to [[<tvar name=1>Special:LanguageStats</tvar>|translatable pages]] in the user's language.</translate> | ||
It uses the special page prefix <code>Special:MyLanguage/</code>, 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>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> | |||
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. | ||
== Usage == <!--T:2--> | == Usage == <!--T:2--> | ||
</translate> | </translate> | ||
{{Localized link/doc}} | {{Localized link/doc}} | ||
If "<code>nsp</code>" parameter is not defined, as link text displays the full pagename (including namespace); otherwise — if "<code>nsp</code>" parameter is defined by any value — link text displays the short pagename, without namespace. | <translate> | ||
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. | |||
=== Examples of simple usage === <!--T:3--> | === Examples of simple usage === <!--T:3--> | ||
</translate> | </translate> | ||
| Line 60: | Line 60: | ||
<translate> | <translate> | ||
== Usage in translatable pages == <!--T:6--> | == Usage in translatable pages == <!--T:6--> | ||
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> | ||
# Should better be substitute this template, and then the wikilink target embedded in a < | # <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> | ||
#: As example, instead <code><nowiki>{{ll|Communication|About communication}}</nowiki></code>, translation markup in translatable page will be <code><nowiki>[[<tvar | #: 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>. | ||
# Alternatively, may be exclude this code from translatable section. | # <translate>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>. | ||
#: This is useful for bulleted lists of links, e.g. in the "See also:" sections. | #: <translate>This is useful for bulleted lists of links, e.g. in the "See also:" sections.</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 {{tag|tvar|open}}. | # <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|1>{{tag|tvar|open}}</>.</translate> | ||
#: As example, instead {{Tlx|ll|Communication}}, translation markup in translatable page will be <code><nowiki><tvar | #: As example, instead {{Tlx|ll|Communication}}, translation markup in translatable page will be <code><nowiki><tvar name=1>{{ll|Communication}}</tvar></nowiki></code>. | ||
<translate> | <translate> | ||
== See also == <!--T:7--> | == See also == <!--T:7--> | ||
</translate> | </translate> | ||
* [[Template:Localized link/messagedoc]] — should be used for message documentation in translatable pages that use this template. | * [[Template:Localized link/messagedoc]] — <translate>should be used for message documentation in translatable pages that use this template.</translate> | ||
* {{tl|Translatable template}} | * {{tl|Translatable template}} - <translate>alias <tvar|1>{{tl|TNT}}</> or <tvar|2>{{tl|tnt}}</></translate> | ||
* {{tl|Translatable template name}} | * {{tl|Translatable template name}} - <translate>alias <tvar|1>{{tl|TNTN}}</> or <tvar|2>{{tl|tntn}}</></translate> | ||
* {{tl|Page language link}} | * {{tl|Page language link}} - <translate>alias <tvar|1>{{tl|pll}}</></translate> - <translate>add a link from a translatable page to another translatable page in the same language</translate> | ||
}} | }} | ||
[[Category:Internationalization templates]] | [[Category:Internationalization templates]] | ||
</noinclude> | </noinclude> | ||