Difference between revisions of "Template:Localized link"
prepare for translation
>Shirayuki (move doc here to make translatable) |
>Shirayuki (prepare for translation) |
||
| Line 1: | Line 1: | ||
{{#ifeq:{{FULLPAGENAME:{{{1}}}}}|{{FULLPAGENAME:{{translatable}}}}<!--self link (including translation pages)--> | <noinclude> | ||
<languages/> | |||
</noinclude><!-- | |||
-->{{#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/{{pagelang2}}<!--if the source page, pagelang2 returns en--> | }}[[Special:MyLanguage/{{{1}}}|{{#if:{{{2|}}}|{{{2}}}|{{{2|{{#ifexist:Translations:{{#if:{{NAMESPACE:{{{1}}}}}|{{NAMESPACE:{{{1}}}}}:}}{{PAGENAME:{{{1}}}}}/Page display title/{{pagelang2}}<!--if the source page, pagelang2 returns en--> | ||
| Line 19: | Line 22: | ||
{{High-use|35000}} | {{High-use|35000}} | ||
<translate> | |||
== Purpose == | == Purpose == | ||
</translate> | |||
This helper template can be used to link to [[Special:LanguageStats|translatable pages]] in the user's language. It uses the special page prefix <code>Special:MyLanguage/</code>, 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. | This helper template can be used to link to [[Special:LanguageStats|translatable pages]] in the user's language. | ||
It uses the special page prefix <code>Special:MyLanguage/</code>, 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. | 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. | ||
<translate> | |||
== Usage == | == Usage == | ||
</translate> | |||
{{Localized link/doc}} | {{Localized link/doc}} | ||
If "<code>nsp</code>" parameter is not defined, as link text displays the full pagename (including namespace); otherwise — if "<code>nsp</code>" parameter is defined by any value — link text displays the short pagename, without namespace. | If "<code>nsp</code>" parameter is not defined, as link text displays the full pagename (including namespace); otherwise — if "<code>nsp</code>" parameter is defined by any value — link text displays the short pagename, without namespace. | ||
<translate> | |||
=== Examples of simple usage === | === Examples of simple usage === | ||
</translate> | |||
{{(}}{{!}} class="wikitable" | {{(}}{{!}} class="wikitable" | ||
{{!}}- | {{!}}- | ||
! Use | ! <translate>Use</translate> | ||
! Becomes | ! <translate>Becomes</translate> | ||
{{!}}- | {{!}}- | ||
{{!}} {{Tlx{{!}}ll{{!}}Communication}} | {{!}} {{Tlx{{!}}ll{{!}}Communication}} | ||
| Line 51: | Line 58: | ||
{{!}}{{)}} | {{!}}{{)}} | ||
<translate> | |||
== Usage in translatable pages == | == Usage in translatable pages == | ||
</translate> | |||
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 <code><nowiki><tvar|id>...</></nowiki></code>, 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 <code><nowiki>[[<tvar|1>Special:MyLanguage/Communication</>|About communication]]</nowiki></code>. | |||
# Should better be substitute this template, and then the wikilink target embedded in a <code><nowiki><tvar|id>...</></nowiki></code>, 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 <code><nowiki>[[<tvar|1>Special:MyLanguage/Communication</>|About communication]]</nowiki></code>. | |||
# 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 | ||
| Line 64: | Line 72: | ||
#: As example, instead {{Tlx|ll|Communication}}, translation markup in translatable page will be <code><nowiki><tvar|1>{{ll|Communication}}</></nowiki></code>. | #: As example, instead {{Tlx|ll|Communication}}, translation markup in translatable page will be <code><nowiki><tvar|1>{{ll|Communication}}</></nowiki></code>. | ||
<translate> | |||
== See also == | == See also == | ||
</translate> | |||
* [[Template:Localized link/messagedoc]] — should be used for message documentation in translatable pages that use this template. | * [[Template:Localized link/messagedoc]] — should be used for message documentation in translatable pages that use this template. | ||
* {{tl|Translatable template}}, alias {{tl|TNT}} or {{tl|tnt}} | * {{tl|Translatable template}}, alias {{tl|TNT}} or {{tl|tnt}} | ||