Template:Localized link

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

Template documentation

[view] [edit] [history] [purge]

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 Meta-Wiki) 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.

Simple usage

It is used in the same way normal wikilinks are used: One parameter to use the same link text as the page name, two parameters for different page name and link text.

If second parameter is not defined, link text will display the name of the target page in the language corresponding to the language of the current page (if exist; otherwise — English name).

Examples of simple using

Use	Becomes
{{ll|Meta:About}}	Meta:About
{{ll|Meta:About|{{int:about}}}}	About

Usage in translatable pages

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

1. Should better be substitute this template, and then the wikilink target embedded in a <tvar name="...">...</tvar>, separately from the translatable displayed text of the link.

   As example, instead {{ll|Meta:About|About Meta-Wiki}}, translation markup in translatable page will be [[<tvar name="about-meta">Special:MyLanguage/Meta:About</tvar>|About Meta-Wiki]].

2. Alternatively, may be exclude this code from translatable section and

   As example, for some text {{ll|Meta:About|About Meta-Wiki}} some text , translation markup in translatable page will be

   <translation>some text</translation> {{ll|Meta:About|2=<translation>About Meta-Wiki</translation>}} <translation>some text</translation>.

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

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

   As example, instead {{ll|Meta:About}}, translation markup in translatable page will be <tvar name="about-meta">{{ll|Meta:About}}</tvar>.

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

TemplateData

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

TemplateData for Localized link

No description.

Template parameters[Edit template data]

Parameter		Description	Type	Status
Page Name	1	Linked page name.	Page name	required
Display Text	2	Displayed link text. Default {{Translations:{{{1}}}/Page_display_title/{{PAGELANGUAGE}}}}	Line	suggested
Interwiki Prefix	iw	The Interwiki prefix. See [[Special:Interwiki]] for a list of valid values. Note that the target wiki must use MediaWiki-style page names and support “Special:MyLanguage”.	String	optional
Show Namespace Prefix?	nsp	Whether to include the namespace prefix, ignored if parameter 2 is passed. Default 1 Auto value 0	Boolean	optional

Edit parameter translations

See also

• Template:Localized link/messagedoc – should be used for message documentation in translatable pages that use this template.

The above documentation is transcluded from Template:Localized link/doc. (edit | history)
Editors can experiment in this template’s sandbox (create | mirror) and testcases (create) pages.
Please add categories to the /doc subpage. Subpages of this template.