Template:Localized link

Note: This template is used on a lot of pages. In order not to put too much load on the servers, edits should be kept to a bare minimum. Please discuss proposed changes on the talk page first. Afterwards, changes can initially be done at and tested with Template:Localized link/sandbox. Editing a template causes all pages that use the template to be re-rendered. If the template is used often, this can put a lot of load on the servers since it fills up the job queue. Keep in mind that templates that are used on file description pages also show up on other wikis. This page has been protected from editing to prevent vandalism. Only administrators can edit it. Get their attention by placing {{Edit protected}} at the talk page.

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

This template has been protected from editing to prevent vandalism. Please discuss changes on the talk page or request unprotection.

Template documentation[ view · edit · history · purge ]

This documentation is transcluded from Template:Localized link/doc.

This template can be used to link to translatable pages in the user’s language. It uses the special page 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 the English version if there isn’t.

It may be used in translated pages, so that they link to the right page even if there is no translated page in that language.

Usage

{{Localized link |1= |2= }}

Template parameters

 Parameter text is empty

<templatedata>JSON</templatedata> ./. {{TemplateBox}}

TemplateData

TemplateData is a way to store information about template parameters (the description of those and of the whole template) for both humans and machines. It is used by VisualEditor and possibly other tools like Upload Wizard.

---

Existing template documentation
At Wikimedia Commons, it is recommended to use {{TemplateBox}} with either ‎useTemplateData=1 or ‎useTemplateData=only on the ‎/doc subpage and transcluding it with {{Documentation}} into the template. ‎<nowiki>-tags can be wrapped around the arguments, if required, to avoid templates being expanded.

Newly created template documentation and imports
Another option, especially for imported templates, or for users with JSON experience, is placing raw ‎<templatedata>-tags into the Wikitext of the template, as described in various Wikipediae.

Discussion
There is an ongoing discussion about that matter. Feel invited to comment if you are experienced in either way, your time permits and if you like to share your opinion or to make a suggestion.

---

Wikipedia's help about TemplateData • Commons-specific information

This template can be used to link to translatable pages in the user’s language. It uses the special page 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 the English version if there isn’t. It may be used in translated pages, so that they link to the right page even if there is no translated page in that language.

Template parameters[Edit template data]

This template prefers inline formatting of parameters.

Parameter		Description	Type	Status
target	1	Target of the link	Page name	required
link text	2	The displayed text of the link. If empty, the template tries to use the translated title of the target page in the user’s language, else it shows the target title.	Line	optional

Additional information

The template is intended to be used in the following namespaces: no namespace specified

The template is intended to be used by the following user groups: no user group specified

Example

{{Localized link|Commons:Welcome}}<br>{{Localized link|Commons:Welcome|关于}}

renders as:

Commons:Welcome
关于

See also

• {{Pg}} More suitable for Commons help pages. Similar functionality, but on non-English pages attempts to link first to a version of the target page in the current page language, then in the user’s preferred language, then in English as a last resort.
• Template:Localized link/messagedoc – should be used for message documentation in translatable pages that use this template.

Localization

This template is not intended to be localized.