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.


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}}
Anonymous user