Template:Localized link

[[Special:MyLanguage/{{{1}}}|{{{1}}}]][[:{{{1}}}| ]]

Template documentation

Purpose

This helper template can be used to link to translatable pages in the user's language. It uses the special page prefix Special:MyLanguage/, 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.

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

This is the TemplateData documentation for this template used by VisualEditor and other tools.

Localized link

Link to translatable page in the user’s language. It uses the special page prefix “Special:MyLanguage/”.

Template parameters[Edit template data]

This template prefers inline formatting of parameters.

Parameter		Description	Type	Status
Page name	1	Linked page	Page name	required
Displayed text	2	Display text for this link	Line	suggested
Display the namespace	nsp	If the “nsp” parameter is not defined, as link text displays the full pagename (including namespace); otherwise — if “nsp” parameter is defined by any value — link text displays the short pagename, without namespace. Auto value 0	String	optional

If the "nsp" parameter is not defined, as link text this displays the full pagename (including the namespace); otherwise — if the "nsp" parameter is defined to any value the link text displays the short pagename (without the namespace).

Examples of simple usage

Use	Becomes
{{ll|Communication}}	Communication
{{ll|Communication|コミュニケーション}}	コミュニケーション
{{ll|Project:About}}	Project:About
{{ll|Project:About|nsp=0}}	About

Usage in translatable pages

On pages prepared for translation with the Extension:Translate extension, this template may be used in three ways.

1. Substitute this template, then embed the wikilink target in a <tvar name=id>...</tvar>, separate from the translatable text of the link.

   For example, instead of {{ll|Communication|About communication}}, the translation markup in the translatable page will be [[<tvar name=1>Special:MyLanguage/Communication</tvar>|About communication]].

2. Alternatively, exclude this code from the translatable section.

   For example, for some text {{ll|Communication|About communication}} some text, the translation markup in the translatable page will be:

   <translate>some text</translate> {{ll|Communication|2=<translate>About communication</translate>}} <translate>some text</translate>

   This is useful for bulleted lists of links, e.g. in the "See also:" sections.

3. If link text is the same as the name of the target page, all of the code could also be embedded into ‎<tvar>.

   For example, instead of {{ll|Communication}}, the wikicode in the translatable page will be <tvar name=1>{{ll|Communication}}</tvar>.

Test cases

Subpage
{{Localized link|Extension:DiscussionTools/Comparison}} {{Localized link}} Extension:DiscussionTools/Comparison {{Localized link/sandbox}} Extension:DiscussionTools/Comparison

Hide namespace
{{Localized link|Extension:DiscussionTools/Comparison|nsp=0}} {{Localized link}} Extension:DiscussionTools/Comparison {{Localized link/sandbox}} Extension:DiscussionTools/Comparison

Hide namespace with {{LC zh }}'s namespace setting
{{Localized link|Project:About|nsp=0}} {{Localized link}} About {{Localized link/sandbox}} About

See also

• Template:Localized link/messagedoc — should be used for message documentation in translatable pages that use this template.
• {{Translatable template }} - alias {{TNT }} or {{Tnt }}
• {{Translatable template name }} - alias {{TNTN }} or {{Tntn }}
• {{Page language link }} - alias {{Pll }} - add a link from a translatable page to another translatable page in the same language

Editors can experiment in this template’s sandbox (create | mirror) and testcases (create) pages.
Subpages of this template.