Template:Localized link
<languages/> [[Special:MyLanguage/{{{1}}}|{{{1}}}]]
This template is used on approximately 35,000 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them. |
<translate>
Purpose
</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> It uses the special page prefix <tvar name=1>Special:MyLanguage/
</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.
Usage
</translate> Template:Localized link/doc
<translate>
If "<tvar name=1>nsp
</tvar>" parameter is not defined, as link text displays the full pagename (including namespace); otherwise — if "<tvar name=1>nsp
</tvar>" parameter is defined by any value — link text displays the short pagename, without namespace.
Examples of simple usage
</translate>
<translate> Use</translate> | <translate> Becomes</translate> |
---|---|
{{ll|Communication}} | Communication |
{{ll|Communication|コミュニケーション}} | コミュニケーション |
{{ll|Project:About}} | Project:About |
{{ll|Project:About|nsp=0}} | About |
<translate>
Usage in translatable pages
On pages prepared for translation with the <tvar name=1>Extension:Translate </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 <tvar name=1><syntaxhighlight lang="html" inline="1">Template:^(tvar name=idTemplate:)^...Template:^(/tvarTemplate:)^</syntaxhighlight></tvar>, separately from the translatable displayed text of the link.</translate>
- <translate> As example, instead <tvar name=1>
{{ll|Communication|About communication}}
</tvar>, translation markup in translatable page will be <tvar name=2><syntaxhighlight lang="html" inline="1">[[Template:^(tvar name=1Template:)^Special:MyLanguage/CommunicationTemplate:^(/tvarTemplate:)^|About communication]]</syntaxhighlight></tvar>.</translate>
- <translate> As example, instead <tvar name=1>
- <translate> Alternatively, may be exclude this code from translatable section.</translate>
- <translate> As example, for <tvar name=1>
some text {{ll|Communication|About communication}} some text
</tvar>, translation markup in translatable page will be:</translate> - <syntaxhighlight lang="html" inline="1">Template:^(translateTemplate:)^some textTemplate:^(/translateTemplate:)^ {{ll|Communication|2=Template:^(translateTemplate:)^About communicationTemplate:^(/translateTemplate:)^}} Template:^(translateTemplate:)^some textTemplate:^(/translateTemplate:)^</syntaxhighlight>
- <translate> This is useful for bulleted lists of links, e.g. in the "See also:" sections.</translate>
- <translate> As example, for <tvar name=1>
- <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>
<tvar>
</tvar>.</translate>- <translate> As example, instead <tvar name=1>{{ll|Communication}}</tvar>, translation markup in translatable page will be <tvar name=2><syntaxhighlight lang="html" inline="1">Template:^(tvar name=1Template:)^{{ll|Communication}}Template:^(/tvarTemplate:)^</syntaxhighlight></tvar>.</translate>
<translate>
See also
</translate>
- Template:Localized link/messagedoc — <translate> should be used for message documentation in translatable pages that use this template.</translate>
- {{Translatable template}} - <translate> alias <tvar name=1>{{TNT}}</tvar> or <tvar name=2>{{tnt}}</tvar></translate>
- {{Translatable template name}} - <translate> alias <tvar name=1>{{TNTN}}</tvar> or <tvar name=2>{{tntn}}</tvar></translate>
- {{Page language link}} - <translate> alias <tvar name=1>{{pll}}</tvar></translate> - <translate> add a link from a translatable page to another translatable page in the same language</translate>
[[Category:Template documentation pages{{#translation:}}]]