Шаблон:Language/doc

{{Documentation subpage}}
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->

This template is used to convert [[ISO 639]] language ''codes'' into language ''names''

=== Usage ===

*'''Parameter 1''' ''(compulsory)'' is the [[ISO 639-1]] (two-letter) or [[ISO 639-2]] (three letter) code for the language to output.
*'''Parameter 2''' ''(optional)'' is the two- or three-letter code for the language ''the result should be displayed in''. If no valid parameter is given, the default is <code>en</code>

Please note that this system requires a huge number of separate language names (~35,000) and so is currently very incomplete. If the required name has not already been defined for a particular language, the template will display an error (if ''no'' translations have been specified for the language, english translations will be returned).  If you feel confident enough with a language that is not already defined, please take a few moments to create a new set of definitions for it. 

====Examples====

*<tt><nowiki>{{language|en}}</nowiki></tt> &rarr; {{language|en}}
*<tt><nowiki>{{language|fr}}</nowiki></tt> &rarr; {{language|fr}}
*<tt><nowiki>{{language|en|fr}}</nowiki></tt> &rarr; {{language|en|fr}}
*<tt><nowiki>{{language|fr|en}}</nowiki></tt> &rarr; {{language|fr|en}}
*<tt><nowiki>{{language|fr|fr}}</nowiki></tt> &rarr; {{language|fr|fr}}

===Technical details===

This template works by calling a subpage with the relevant language code for the ''second'' parameter (the return language); this subpage contains a switch statement that converts the first parameter into the name in the appropriate language.  See for instance {{tlx|language/en}}, which is called to translate codes into English.  

Because some language codes are very uncommon, it is possible to split a language into two subpages, eg <tt>/fr</tt> and <tt>/fr+</tt>.  The /fr page is called first, and should contain the more common languages.  Less common languages should be added to the /fr+ page, which is called only if no translation is found in the main subpage; between them, the two pages should contain all the available translations.

=== See also ===
* [[commons:Template:Language/en]] - converts many language codes into English names. Its main purpose is conversion of the codes used in Wikimedia (Names.php and wiki names) but many are ISO codes as well.
<includeonly>
<!-- CATEGORIES AND INTERWIKIS BELOW THIS LINE PLEASE -->
[[Category:ISO language templates]]
[[pt:Predefinição:Iso2Lang]]
</includeonly>