Jump to content

Template:Localized link

<translate> {{<tvar name=1>PLURAL:2</tvar>|shortcut|shortcuts}}:</translate> Template:Mono Template:Mono
From p1gwars
Revision as of 15:58, 11 January 2026 by Rosie (talk | contribs) (Created page with "<noinclude> <languages/> </noinclude><!-- -->{{#ifeq:{{FULLPAGENAME:{{{1}}}}}|{{FULLPAGENAME:{{translatable}}}}<!--self link (including translation pages)--> |<b> }}<!---->Special:MyLanguage/{{{1}}}|{{#if:{{{2|}}} |{{{2}}} |{{{2|{{#ifexist:Translations:{{#if:{{NAMESPACE:{{{1}}}}}|{{NAMESPACE:{{{1}}}}}:}}{{PAGENAME:{{{1}}}}}/Page display title/{{PAGELANGUAGE}}<!--if the source page, PAGELANGUAGE returns en--> |{{#ifexpr:{{#if:{{{nsp|}}}|1|0}} and {{NAMESPACENUMBER:{...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

<languages/> [[Special:MyLanguage/{{{1}}}|{{{1}}}]][[:{{{1}}}| ]]

Template documentation

<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>

Usage

</translate> Template:Localized link/doc

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

When linking to a section within a page, the section is not displayed in the link text.

Examples of simple usage

</translate>

<translate> Use</translate> <translate> Becomes</translate>
{{ll|Communication}} Communication
{{ll|Communication|コミュニケーション}} コミュニケーション
{{ll|Project:About}} Project:About
{{ll|Project:About#See_also}} Project:About#See_also
{{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>

  1. <translate> Substitute this template, then embed the wikilink target in a <tvar name=1><syntaxhighlight lang="html" inline="1"><tvar name=id>...</tvar></syntaxhighlight></tvar>, separate from the translatable text of the link.</translate>
    <translate> For example:</translate> <syntaxhighlight lang="html" inline="1">Learn more {{<tvar name=1>ll|Communication</tvar>|about communication}}.</syntaxhighlight>
  2. <translate> 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><tvar></tvar>.</translate>
    <translate> For example:</translate> <syntaxhighlight lang="html" inline="1">Learn more about <tvar name=1>{{ll|Communication}}</tvar>.</syntaxhighlight>
  3. <translate> For standalone links, such as in a list or table, translate only the link text if it differs from the name of the target page.</translate> <translate> This is useful for bulleted lists of links, e.g. in the "See also:" sections.</translate> <translate> Make sure to include the parameter name when adding translate tags inside template syntax.</translate>
    <translate> For example:</translate>
<syntaxhighlight lang="html" inline="1">* {{ll|Project:About}}</syntaxhighlight>
<syntaxhighlight lang="html" inline="1">* {{ll|Communication|2=<translate>About communication</translate>}}</syntaxhighlight>

Test cases

Template:Localized link/testcases

<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:}}]]

[[Category:Internationalization templates{{#translation:}}]]