View source for Vorlage:Localized link/doc

{{Documentation/subpage}}

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

== Simple usage ==
It is used in the same way normal wikilinks are used: One parameter to use the same link text as the page name, two parameters for different page name and link text. 

If second parameter is not defined, link text will display the name of the target page in the language corresponding to the language of the current page (if exist; otherwise — English name). 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 using ===
{| class="wikitable"
|-
! Use
! Becomes
|-
| <code><nowiki>{{ll|Communication}}</nowiki></code>
| {{ll|Communication}}
|-
| <code><nowiki>{{ll|Communication|コミュニケーション}}</nowiki></code>
| {{ll|Communication|コミュニケーション}}
|-
| <code><nowiki>{{ll|Project:About}}</nowiki></code>
| {{ll|Project:About}}
|-
| <code><nowiki>{{ll|Project:About|nsp=0}}</nowiki></code>
| {{ll|Project:About|nsp=0}}
|}

== Usage in translatable pages ==

On pages prepared for translation with the [[Extension:Translate|Translate extension]], this template may used in three ways. 
# Should better be substitute this template, and then the wikilink target embedded in a <code><tvar|id>...</></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|comm>Special:MyLanguage/Communication</>|About communication]]</nowiki></code>. 
# Alternatively, may be exclude this code from translatable section and 
#: As example, for <code> some text <nowiki>{{ll|Communication|About communication}}</nowiki> some text </code>, translation markup in translatable page will be 
#: <code><translation>some text</translation> <nowiki>{{ll|Communication|<translation>About communication</translation>}}</nowiki> <translation>some text</translation></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 <code><nowiki><tvar></nowiki></code>.
#: As example, instead <code><nowiki>{{ll|Communication}}</nowiki></code>, translation markup in translatable page will be <code><nowiki><tvar|about-meta>{{ll|Communication}}</></nowiki></code>.

== See also ==

* [[Template: Ldt]] – '''l'''ocalized '''d'''isplay '''t'''itle

=== Technical Dependencies ===
* [[Template: Localized link/get source title]]
* [[Template: Localized link/messagedoc]] – should be used for message documentation in translatable pages that use this template.
* {{tl|Translatable template}}
* {{tl|Translatable template name}}, alias {{tl|TNTN}} or {{tl|tntn}}
{{Languages|Template:Localized link/doc}}
<includeonly>
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS BELOW THIS LINE, INSIDE INCLUDEONLY TAGS. -->
[[Category:Internationalization templates]]
</includeonly>