Difference between revisions of "Template:Localized link"
move doc here to make translatable
>Shirayuki (avoid being listed in Special:WantedPages) |
>Shirayuki (move doc here to make translatable) |
||
Line 14: | Line 14: | ||
|</b> | |</b> | ||
}}<span style="display:none">[[:{{{1}}}| ]]</span><!-- T63547 --><noinclude> | }}<span style="display:none">[[:{{{1}}}| ]]</span><!-- T63547 --><noinclude> | ||
{{ {{TNTN| | {{documentation|content= | ||
{{tsh|ll|LL}} | |||
{{High-use|35000}} | |||
== Purpose == | |||
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. | |||
== Usage == | |||
{{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. | |||
=== Examples of simple usage === | |||
{{(}}{{!}} class="wikitable" | |||
{{!}}- | |||
! Use | |||
! Becomes | |||
{{!}}- | |||
{{!}} {{Tlx{{!}}ll{{!}}Communication}} | |||
{{!}} {{ll{{!}}Communication}} | |||
{{!}}- | |||
{{!}} {{Tlx{{!}}ll{{!}}Communication{{!}}コミュニケーション}} | |||
{{!}} {{ll{{!}}Communication{{!}}コミュニケーション}} | |||
{{!}}- | |||
{{!}} {{Tlx{{!}}ll{{!}}Project:About}} | |||
{{!}} {{ll{{!}}Project:About}} | |||
{{!}}- | |||
{{!}} {{Tlx{{!}}ll{{!}}Project:About{{!}}nsp{{=}}0}} | |||
{{!}} {{ll{{!}}Project:About{{!}}nsp=0}} | |||
{{!}}{{)}} | |||
== Usage in translatable pages == | |||
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>. | |||
# 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 | |||
#: <code><translate>some text</translate> <nowiki>{{ll|Communication|<translate>About communication</translate>}}</nowiki> <translate>some text</translate></code>. | |||
#: 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}}. | |||
#: As example, instead {{Tlx|ll|Communication}}, translation markup in translatable page will be <code><nowiki><tvar|1>{{ll|Communication}}</></nowiki></code>. | |||
== See also == | |||
* [[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 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 | |||
}} | |||
[[Category:Internationalization templates]] | |||
</noinclude> | </noinclude> |