<translate> {{<tvar name=1>PLURAL:Script error: No such module "Loops".</tvar>|shortcut|shortcuts}}:</translate> Script error: No such module "Loops".

Template:Localized link: Difference between revisions

From The Maceys in California

Lynn Macey (talk | contribs)

3 user groups
1,538 edits
VisualWikitext
Created page with "<noinclude> <languages/> </noinclude><!-- -->{{#ifeq:{{FULLPAGENAME:{{{1}}}}}|{{FULLPAGENAME:{{translatable}}}}<!--self link (including translation pages)--> |<b> }}<!---->Special:MyLanguage/{{{1}}}|{{#if:{{{2|}}} |{{{2}}} |{{{2|{{#ifexist:Translations:{{#if:{{NAMESPACE:{{{1}}}}}|{{NAMESPACE:{{{1}}}}}:}}{{PAGENAME:{{{1}}}}}/Page display title/{{PAGELANGUAGE}}<!--if the source page, PAGELANGUAGE returns en--> |{{#ifexpr:{{#if:{{{nsp|}}}|1|0}} and {{NAMESPACENUMBER:{..."
 
No edit summary
 
Line 50: Line 50:
<translate><!--T:8--> This helper template can be used to link to [[<tvar name=1>Special:LanguageStats</tvar>|translatable pages]] in the user's language.</translate>
<translate><!--T:8--> This helper template can be used to link to [[<tvar name=1>Special:LanguageStats</tvar>|translatable pages]] in the user's language.</translate>
<translate><!--T:9--> It uses the special page prefix <tvar name=1><code>Special:MyLanguage/</code></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><!--T:9--> It uses the special page prefix <tvar name=1><code>Special:MyLanguage/</code></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>
<translate>
<!--T:10-->
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 == <!--T:2-->
== Usage == <!--T:2-->
</translate>
</translate>
Line 62: Line 58:
<!--T:11-->
<!--T:11-->
If the "<tvar name=1><code>nsp</code></tvar>" parameter is not defined, as link text this displays the full pagename (including the namespace); otherwise — if the "<tvar name=1><code>nsp</code></tvar>" parameter is defined to any value the link text displays the short pagename (without the namespace).
If the "<tvar name=1><code>nsp</code></tvar>" parameter is not defined, as link text this displays the full pagename (including the namespace); otherwise — if the "<tvar name=1><code>nsp</code></tvar>" parameter is defined to any value the link text displays the short pagename (without the namespace).
<!--T:25-->
When linking to a section within a page, the section is not displayed in the link text.


=== Examples of simple usage === <!--T:3-->
=== Examples of simple usage === <!--T:3-->
Line 78: Line 77:
{{!}} {{Tlx|ll|Project:About}}
{{!}} {{Tlx|ll|Project:About}}
{{!}} {{ll|Project:About}}
{{!}} {{ll|Project:About}}
{{!}}-
{{!}} {{Tlx|ll|Project:About#See_also}}
{{!}} {{ll|Project:About#See_also}}
{{!}}-
{{!}}-
{{!}} {{Tlx|ll|Project:About|nsp{{=}}0}}
{{!}} {{Tlx|ll|Project:About|nsp{{=}}0}}
Line 91: Line 93:


# <translate><!--T:13--> Substitute this template, then embed the wikilink target in a <tvar name=1>{{#tag:syntaxhighlight|{{^(}}tvar name=id{{)^}}...{{^(}}/tvar{{)^}}|lang=html|inline=1}}</tvar>, separate from the translatable text of the link.</translate>
# <translate><!--T:13--> Substitute this template, then embed the wikilink target in a <tvar name=1>{{#tag:syntaxhighlight|{{^(}}tvar name=id{{)^}}...{{^(}}/tvar{{)^}}|lang=html|inline=1}}</tvar>, separate from the translatable text of the link.</translate>
#: <translate><!--T:22--> For example, instead of <tvar name=1><code><nowiki>{{ll|Communication|About communication}}</nowiki></code></tvar>, the translation markup in the translatable page will be <tvar name=2>{{#tag:syntaxhighlight|[[{{^(}}tvar name=1{{)^}}Special:MyLanguage/Communication{{^(}}/tvar{{)^}}|About communication]]|lang=html|inline=1}}</tvar>.</translate>
#: <translate><!--T:26--> For example:</translate> {{#tag:syntaxhighlight|Learn more {{{{^(}}tvar name=1{{)^}}ll|Communication{{^(}}/tvar{{)^}}|about communication}}.|lang=html|inline=1}}
# <translate><!--T:14--> Alternatively, exclude this code from the translatable section.</translate>
#: <translate><!--T:23--> For example, for <tvar name=1><code>some text <nowiki>{{ll|Communication|About communication}}</nowiki> some text</code></tvar>, the translation markup in the translatable page will be:</translate>
#: {{#tag:syntaxhighlight|{{^(}}translate{{)^}}some text{{^(}}/translate{{)^}} {{((}}ll{{!}}Communication{{!}}2={{^(}}translate{{)^}}About communication{{^(}}/translate{{)^}}{{))}} {{^(}}translate{{)^}}some text{{^(}}/translate{{)^}}|lang=html|inline=1}}
#: <translate><!--T:15--> This is useful for bulleted lists of links, e.g. in the "See also:" sections.</translate>
# <translate><!--T:16--> 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>{{tag|tvar|open}}</tvar>.</translate>
# <translate><!--T:16--> 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>{{tag|tvar|open}}</tvar>.</translate>
#: <translate><!--T:24--> For example, instead of <tvar name=1>{{Tlx|ll|Communication}}</tvar>, the wikicode in the translatable page will be <tvar name=2>{{#tag:syntaxhighlight|{{^(}}tvar name=1{{)^}}{{((}}ll{{!}}Communication{{))}}{{^(}}/tvar{{)^}}|lang=html|inline=1}}</tvar>.</translate>
#: <translate><!--T:27--> For example:</translate> {{#tag:syntaxhighlight|Learn more about {{^(}}tvar name=1{{)^}}<nowiki>{{ll|Communication}}</nowiki>{{^(}}/tvar{{)^}}.|lang=html|inline=1}}
# <translate><!--T:28--> 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><!--T:15--> This is useful for bulleted lists of links, e.g. in the "See also:" sections.</translate> <translate><!--T:29--> Make sure to include the parameter name when adding translate tags inside template syntax.</translate>
#: <translate><!--T:30--> For example:</translate>
::: {{#tag:syntaxhighlight|* {{((}}ll{{!}}Project:About{{))}}|lang=html|inline=1}}
::: {{#tag:syntaxhighlight|* {{((}}ll{{!}}Communication{{!}}2={{^(}}translate{{)^}}About communication{{^(}}/translate{{)^}}{{))}}|lang=html|inline=1}}


== Test cases ==
== Test cases ==
Line 110: Line 112:
* {{tl|Page language link}} - <translate><!--T:20--> alias <tvar name=1>{{tl|pll}}</tvar></translate> - <translate><!--T:21--> add a link from a translatable page to another translatable page in the same language</translate>
* {{tl|Page language link}} - <translate><!--T:20--> alias <tvar name=1>{{tl|pll}}</tvar></translate> - <translate><!--T:21--> add a link from a translatable page to another translatable page in the same language</translate>
}}
}}
[[Category:Internationalization templates]]
[[Category:Internationalization templates{{#translation:}}]]
</noinclude>
</noinclude>

Latest revision as of 21:41, 17 August 2026

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

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

Usage

</translate> Lua error: expandTemplate: template loop detected. Lua error: expandTemplate: template loop detected.

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.

ParameterDescriptionTypeStatus
Page name1

Linked page

Page namerequired
Displayed text2

Display text for this link

Linesuggested
Display the namespacensp

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
Stringoptional

onlyinclude>[[Category:Internationalization templates{{#translation:}}]] [[Category:Internal link templates{{#translation:}}]]</onlyinclude> Lua error: expandTemplate: template loop detected.


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

<translate> Use</translate> <translate> Becomes</translate>
{{ll|Communication}} Template:Ll
{{ll|Communication|コミュニケーション}} Template:Ll
{{ll|Project:About}} Template:Ll
{{ll|Project:About#See_also}} Template:Ll
{{ll|Project:About|nsp=0}} Template:Ll

<translate>

Usage in translatable pages

On pages prepared for translation with the <tvar name=1>Template: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><tvar name=id>...</tvar></tvar>, separate from the translatable text of the link.</translate>
    <translate> For example:</translate> Learn more {{<tvar name=1>ll|Communication</tvar>|about communication}}.
  2. <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:</translate> Learn more about <tvar name=1>{{ll|Communication}}</tvar>.
  3. <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>
* {{ll|Project:About}}
* {{ll|Communication|2=<translate>About communication</translate>}}

Test cases

Lua error: expandTemplate: template loop detected. Script error: No such module "Template test case". Script error: No such module "Template test case". Script error: No such module "Template test case".

<translate>

See also

</translate>

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

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

[[Category:Internationalization templates{{#translation:}}]]

Retrieved from "https://wiki.maceys.net/index.php?title=Template:Localized_link&oldid=1525"