Modul:Localized link

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

Module 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> 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> Vorlage: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).

Examples of simple usage

</translate> Vorlage:(| class="wikitable" |- ! <translate> Use</translate> ! <translate> Becomes</translate> |- | {{ll|Communication}} | Vorlage:Ll |- | {{ll|Communication|コミュニケーション}} | Vorlage:Ll |- | {{ll|Project:About}} | Vorlage:Ll |- | {{ll|Project:About|nsp=0}} | Vorlage:Ll |Vorlage:)

<translate>

Usage in translatable pages

On pages prepared for translation with the <tvar name=1>Vorlage:Ll</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">Vorlage:^(tvar name=idVorlage:)^...Vorlage:^(/tvarVorlage:)^</syntaxhighlight></tvar>, separate from the translatable text of the link.</translate>

   <translate> For example, instead of <tvar name=1>{{ll|Communication|About communication}}</tvar>, the translation markup in the translatable page will be <tvar name=2><syntaxhighlight lang="html" inline="1">[[Vorlage:^(tvar name=1Vorlage:)^Special:MyLanguage/CommunicationVorlage:^(/tvarVorlage:)^|About communication]]</syntaxhighlight></tvar>.</translate>

2. <translate> Alternatively, exclude this code from the translatable section.</translate>

   <translate> For example, for <tvar name=1>some text {{ll|Communication|About communication}} some text</tvar>, the translation markup in the translatable page will be:</translate>

   <syntaxhighlight lang="html" inline="1">Vorlage:^(translateVorlage:)^some textVorlage:^(/translateVorlage:)^ Vorlage:((ll|Communication|2=Vorlage:^(translateVorlage:)^About communicationVorlage:^(/translateVorlage:)^Vorlage:)) Vorlage:^(translateVorlage:)^some textVorlage:^(/translateVorlage:)^</syntaxhighlight>

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

3. <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, instead of <tvar name=1>{{ll|Communication}}</tvar>, the wikicode in the translatable page will be <tvar name=2><syntaxhighlight lang="html" inline="1">Vorlage:^(tvar name=1Vorlage:)^Vorlage:((ll|CommunicationVorlage:))Vorlage:^(/tvarVorlage:)^</syntaxhighlight></tvar>.</translate>

Test cases

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

You might want to create a documentation page for this Scribunto module.
Editors can experiment in this module's sandbox (create | mirror) and testcases (create) pages.
Subpages of this module.

[[Category:Template documentation pages{{#translation:}}]]