<languages/> [[Special:MyLanguage/{{{1}}}|{{{1}}}]]
Template:Tsh Template:High-use
<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> Template:(| class="wikitable" |- ! <translate> Use</translate> ! <translate> Becomes</translate> |- | Template:Tlx | Communication |- | Template:Tlx | コミュニケーション |- | Template:Tlx | Project:About |- | Template:Tlx | Project:About#See_also |- | Template:Tlx | About |Template:)
<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>
- <translate> Substitute this template, then embed the wikilink target in a <tvar name=1><syntaxhighlight lang="html" inline="1">Template:^(tvar name=idTemplate:)^...Template:^(/tvarTemplate:)^</syntaxhighlight></tvar>, separate from the translatable text of the link.</translate>
- <translate> For example:</translate> <syntaxhighlight lang="html" inline="1">Learn more {{Template:^(tvar name=1Template:)^ll|CommunicationTemplate:^(/tvarTemplate:)^|about communication}}.</syntaxhighlight>
- <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>Template:Tag</tvar>.</translate>
- <translate> For example:</translate> <syntaxhighlight lang="html" inline="1">Learn more about Template:^(tvar name=1Template:)^{{ll|Communication}}Template:^(/tvarTemplate:)^.</syntaxhighlight>
- <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=Template:^(translateTemplate:)^About communicationTemplate:^(/translateTemplate:)^}}</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>
</nowiki> at the bottom of the template's own page — same single-page pattern already used by {{CategoryInfobox}} and the others, just standardised instead of freehand wikitext each time.
Usage:
<noinclude>
{{Documentation|
== Template:ExampleTemplate ==
One-line description of what the template renders and where it goes.
'''Usage:'''
<pre>
{{ExampleTemplate
|param1=value
|param2=value
}}
</pre>
=== Parameters ===
* '''param1''' — required. What it controls
* '''param2''' — optional. What it controls
}}
</noinclude>
Everything after the pipe — headings, prose, nested <pre> blocks, {{[[Special:MyLanguage/Template:{{{1}}}|Template:{{{1}}}]]}} links — is just ordinary wikitext and gets dropped straight into the box.
Parameters
- 1 (unnamed) or content — the documentation body itself
- category — optional. Overrides the default filing category, if a template shouldn't sit in Vault Templates for some reason
Auto-adds [[Category:Vault Templates]] (or your override) — no need to tag it separately at the bottom of the template page anymore.
</noinclude>
[[Category:Internationalization templates{{#translation:}}]]