Template:Localized link/en: Difference between revisions
Jump to navigation
Jump to search
Template documentation
(Updating to match new version of source page) |
Richardpruen (talk | contribs) m (1 revision imported: Templates and CSS files) |
||
| (2 intermediate revisions by 2 users not shown) | |||
| Line 4: | Line 4: | ||
-->{{#ifeq:{{FULLPAGENAME:{{{1}}}}}|{{FULLPAGENAME:{{translatable}}}}<!--self link (including translation pages)--> | -->{{#ifeq:{{FULLPAGENAME:{{{1}}}}}|{{FULLPAGENAME:{{translatable}}}}<!--self link (including translation pages)--> | ||
|<b> | |<b> | ||
}}[[Special:MyLanguage/{{{1}}}|{{#if:{{{2|}}}|{{{2}}}|{{{2|{{#ifexist:Translations:{{#if:{{NAMESPACE:{{{1}}}}}|{{NAMESPACE:{{{1}}}}}:}}{{PAGENAME:{{{1}}}}}/Page display title/{{ | }}[[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--> | ||
|{{#if:{{{nsp|}}} | |{{#if:{{{nsp|}}} | ||
|{{PAGENAME:{{ {{TNTN|Translations:{{#if:{{NAMESPACE:{{{1}}}}}|{{NAMESPACE:{{{1}}}}}:}}{{PAGENAME:{{{1}}}}}/Page_display_title}} }} }} | |{{PAGENAME:{{ {{TNTN|Translations:{{#if:{{NAMESPACE:{{{1}}}}}|{{NAMESPACE:{{{1}}}}}:}}{{PAGENAME:{{{1}}}}}/Page_display_title}} }} }} | ||
| Line 56: | Line 56: | ||
On pages prepared for translation with the {{ll|Extension:Translate|nsp=0}} extension, this template may be used in three ways. | On pages prepared for translation with the {{ll|Extension:Translate|nsp=0}} extension, this template may be used in three ways. | ||
# Should better be substitute this template, and then the wikilink target embedded in a {{#tag: | # Should better be substitute this template, and then the wikilink target embedded in a {{#tag:syntaxhighlight|{{^(}}tvar name=id{{)^}}...{{^(}}/tvar{{)^}}|lang=html|inline=1}}, separately from the translatable displayed text of the link. | ||
#: As example, instead <code><nowiki>{{ll|Communication|About communication}}</nowiki></code>, translation markup in translatable page will be {{#tag: | #: As example, instead <code><nowiki>{{ll|Communication|About communication}}</nowiki></code>, translation markup in translatable page will be {{#tag:syntaxhighlight|[[{{^(}}tvar name=1{{)^}}Special:MyLanguage/Communication{{^(}}/tvar{{)^}}|About communication]]|lang=html|inline=1}}. | ||
# Alternatively, may be exclude this code from translatable section. | # Alternatively, may be exclude this code from translatable section. | ||
#: As example, for <code>some text <nowiki>{{ll|Communication|About communication}}</nowiki> some text</code>, translation markup in translatable page will be: | #: As example, for <code>some text <nowiki>{{ll|Communication|About communication}}</nowiki> some text</code>, translation markup in translatable page will be: | ||
#: {{#tag: | #: {{#tag:syntaxhighlight|{{^(}}translate{{)^}}some text{{^(}}/translate{{)^}} {{((}}ll{{!}}Communication{{!}}2={{^(}}translate{{)^}}About communication{{^(}}/translate{{)^}}{{))}} {{^(}}translate{{)^}}some text{{^(}}/translate{{)^}}|lang=html|inline=1}} | ||
#: This is useful for bulleted lists of links, e.g. in the "See also:" sections. | #: This is useful for bulleted lists of links, e.g. in the "See also:" sections. | ||
# If link text does not have to be different from the name of landing page, will be better to embed all this code into {{tag|tvar|open}}. | # If link text does not have to be different from the name of landing page, will be better to embed all this code into {{tag|tvar|open}}. | ||
#: As example, instead {{Tlx|ll|Communication}}, translation markup in translatable page will be {{#tag: | #: As example, instead {{Tlx|ll|Communication}}, translation markup in translatable page will be {{#tag:syntaxhighlight|{{^(}}tvar name=1{{)^}}{{((}}ll{{!}}Communication{{))}}{{^(}}/tvar{{)^}}|lang=html|inline=1}}. | ||
== See also == | == See also == | ||
| Line 70: | Line 70: | ||
* {{tl|Translatable template name}} - alias {{tl|TNTN}} or {{tl|tntn}} | * {{tl|Translatable template name}} - alias {{tl|TNTN}} or {{tl|tntn}} | ||
* {{tl|Page language link}} - alias {{tl|pll}} - add a link from a translatable page to another translatable page in the same language | * {{tl|Page language link}} - alias {{tl|pll}} - add a link from a translatable page to another translatable page in the same language | ||
}} | }} | ||
[[Category:Internationalization templates]] | [[Category:Internationalization templates]] | ||
</noinclude> | </noinclude> | ||
Latest revision as of 14:47, 28 October 2022
[[Special:MyLanguage/{{{1}}}|{{{1}}}]]
Template documentation | This template is used on approximately 35,000 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them. |
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 MediaWiki) 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.
Usage
· <span style="" title="<translate nowrap> Edit this template</translate>"><translate> edit</translate>]
This is the TemplateData documentation for this template used by VisualEditor and other tools.
Localized link
Link to translatable page in the user’s language. It uses the special page prefix “Special:MyLanguage/”.
| Parameter | Description | Type | Status | |
|---|---|---|---|---|
| Page name | 1 | Linked page | Page name | required |
| Displayed text | 2 | Display text for this link | Line | suggested |
| Display the namespace | nsp | If “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.
| String | optional |
If "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.
Examples of simple usage
| Use | Becomes |
|---|---|
| {{ll|Communication}} | Communication |
| {{ll|Communication|コミュニケーション}} | コミュニケーション |
| {{ll|Project:About}} | Project:About |
| {{ll|Project:About|nsp=0}} | About |
Usage in translatable pages
On pages prepared for translation with the Extension:Translate extension, this template may be used in three ways.
- Should better be substitute this template, and then the wikilink target embedded in a
<tvar name=id>...</tvar>, separately from the translatable displayed text of the link.- As example, instead
{{ll|Communication|About communication}}, translation markup in translatable page will be[[<tvar name=1>Special:MyLanguage/Communication</tvar>|About communication]].
- As example, instead
- Alternatively, may be exclude this code from translatable section.
- As example, for
some text {{ll|Communication|About communication}} some text, translation markup in translatable page will be: <translate>some text</translate> {{ll|Communication|2=<translate>About communication</translate>}} <translate>some text</translate>- This is useful for bulleted lists of links, e.g. in the "See also:" sections.
- As example, for
- 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|Communication}}, translation markup in translatable page will be
<tvar name=1>{{ll|Communication}}</tvar>.
- As example, instead {{ll|Communication}}, translation markup in translatable page will be
See also
- Template:Localized link/messagedoc — should be used for message documentation in translatable pages that use this template.
- {{Translatable template}} - alias {{TNT}} or {{tnt}}
- {{Translatable template name}} - alias {{TNTN}} or {{tntn}}
- {{Page language link}} - alias {{pll}} - add a link from a translatable page to another translatable page in the same language