Lihimi Tɛmplet:ISO 639 name/doc ni yi shɛli na

{{Documentation subpage}}
<!-- PLEASE ADD CATEGORIES AT THE BOTTOM OF THIS PAGE -->
{{Lua|Module:ISO 639 name}}
{{Language templates}}

== Usage ==
The {{tlx|ISO 639 name}} template is used to resolve [[ISO 639-1]], [[ISO 639-2]], [[ISO 639-3]] and [[ISO 639-5]] codes to language names. It will trim extraneous [[IETF language tag]]s to just the ISO 639 code. E.g.:
Sanskrit in Latin script, which IETF language tag is <code>sa-Latn</code>, renders as:
* <code><nowiki>{{ISO 639 name|sa-Latn}}</nowiki></code> → {{ISO 639 name|sa-Latn|cat=no}}
The error message can be suppressed with {{para|hide-err|yes}}:
* <code><nowiki>{{ISO 639 name|sa-Latn|hide-err=yes}}</nowiki></code> → {{ISO 639 name|sa-Latn|hide-err=yes}}
The rendered language name can be linked to the appropriate language article with {{para|link|yes}}:
* <code><nowiki>{{ISO 639 name|sa-Latn|hide-err=yes|link=yes}}</nowiki></code> → {{ISO 639 name|sa-Latn|hide-err=yes|link=yes}}
When linking, an alternate link label can be provided with {{para|label|&lt;{{var|label text}}>}}:
* <code><nowiki>{{ISO 639 name|sa-Latn|hide-err=yes|link=yes|label=sa-Latn}}</nowiki></code> → {{ISO 639 name|sa-Latn|hide-err=yes|link=yes|label=sa-Latn}}

The {{tlx|ISO 639 name link}} template is the same as {{tnull|ISO 639 name}} except that it presets {{para|link|yes}}.

Both of these templates {{em|can}} be safely substituted.

== Other functions ==
This template can be used to execute any of the functions exported by [[Module:ISO 639 name]].  These function are:
*<code>iso_639_code_exists</code> – returns <code>true</code> if <code>&lt;{{var|code}}></code> is found in any of the ISO 639 data tables
*<code>iso_639_code_to_name</code> – (default) as described above
*<code>iso_639_code_1_to_name</code> – same as <code>iso_639_code_to_name</code> except constrained to the ISO 639-1 data table
*<code>iso_639_code_2_to_name</code> – same as <code>iso_639_code_to_name</code> except constrained to the ISO 639-2 data table
*<code>iso_639_code_2B_to_name</code> – same as <code>iso_639_code_to_name</code> except constrained to the ISO 639-2B data table
*<code>iso_639_code_3_to_name</code> – same as <code>iso_639_code_to_name</code> except constrained to the ISO 639-3 data table
*<code>iso_639_code_5_to_name</code> – same as <code>iso_639_code_to_name</code> except constrained to the ISO 639-5 data table
*<code>iso_639_name_exists</code> – returns <code>true</code> if <code>&lt;{{var|name}}></code> is found in any of the ISO 639 data tables
*<code>iso_639_name_to_code</code> – returns language code associated with <code>&lt;{{var|name}}></code>; may be constrained to a particular ISO 639 data table
*<code>iso_639</code> – returns language name when given a valid language code; returns a language code when given a valid language name; may be constrained to a particular ISO 639 data table
To use these functions set {{para|fn}} to the appropriate function name.

== Language codes ==
{| class="wikitable sortable"
|+ ISO 639-1 codes and matching codes from ISO 639-2, -2B, and -3
! scope="col" | ISO 639-1
! scope="col" | ISO 639-2
! scope="col" | ISO 639-2B{{efn|name="639-2B"}}
! scope="col" | ISO 639-3
! scope="col" | Name
! scope="col" | Article
|-
{{Template:ISO 639 name/doc/row|aa}}
{{Template:ISO 639 name/doc/row|ab}}
{{Template:ISO 639 name/doc/row|ae}}
{{Template:ISO 639 name/doc/row|af}}
{{Template:ISO 639 name/doc/row|ak}}
{{Template:ISO 639 name/doc/row|am}}
{{Template:ISO 639 name/doc/row|an}}
{{Template:ISO 639 name/doc/row|ar}}
{{Template:ISO 639 name/doc/row|as}}
{{Template:ISO 639 name/doc/row|av}}
{{Template:ISO 639 name/doc/row|ay}}
{{Template:ISO 639 name/doc/row|az}}
{{Template:ISO 639 name/doc/row|ba}}
{{Template:ISO 639 name/doc/row|be}}
{{Template:ISO 639 name/doc/row|bg}}
{{Template:ISO 639 name/doc/row|bh|bih||{{efn|name="not assigned"}}}}
{{Template:ISO 639 name/doc/row|bi}}
{{Template:ISO 639 name/doc/row|bm}}
{{Template:ISO 639 name/doc/row|bn}}
{{Template:ISO 639 name/doc/row|bo}}
{{Template:ISO 639 name/doc/row|br}}
{{Template:ISO 639 name/doc/row|bs}}
{{Template:ISO 639 name/doc/row|ca}}
{{Template:ISO 639 name/doc/row|ce}}
{{Template:ISO 639 name/doc/row|ch}}
{{Template:ISO 639 name/doc/row|co}}
{{Template:ISO 639 name/doc/row|cr}}
{{Template:ISO 639 name/doc/row|cs}}
{{Template:ISO 639 name/doc/row|cu}}
{{Template:ISO 639 name/doc/row|cv}}
{{Template:ISO 639 name/doc/row|cy}}
{{Template:ISO 639 name/doc/row|da}}
{{Template:ISO 639 name/doc/row|de}}
{{Template:ISO 639 name/doc/row|dv}}
{{Template:ISO 639 name/doc/row|dz}}
{{Template:ISO 639 name/doc/row|ee}}
{{Template:ISO 639 name/doc/row|el|ell|gre}}
{{Template:ISO 639 name/doc/row|en}}
{{Template:ISO 639 name/doc/row|eo}}
{{Template:ISO 639 name/doc/row|es}}
{{Template:ISO 639 name/doc/row|et}}
{{Template:ISO 639 name/doc/row|eu}}
{{Template:ISO 639 name/doc/row|fa}}
{{Template:ISO 639 name/doc/row|ff}}
{{Template:ISO 639 name/doc/row|fi}}
{{Template:ISO 639 name/doc/row|fj}}
{{Template:ISO 639 name/doc/row|fo}}
{{Template:ISO 639 name/doc/row|fr}}
{{Template:ISO 639 name/doc/row|fy}}
{{Template:ISO 639 name/doc/row|ga}}
{{Template:ISO 639 name/doc/row|gd}}
{{Template:ISO 639 name/doc/row|gl}}
{{Template:ISO 639 name/doc/row|gn}}
{{Template:ISO 639 name/doc/row|gu}}
{{Template:ISO 639 name/doc/row|gv}}
{{Template:ISO 639 name/doc/row|ha}}
{{Template:ISO 639 name/doc/row|he}}
{{Template:ISO 639 name/doc/row|hi}}
{{Template:ISO 639 name/doc/row|ho}}
{{Template:ISO 639 name/doc/row|hr}}
{{Template:ISO 639 name/doc/row|ht}}
{{Template:ISO 639 name/doc/row|hu}}
{{Template:ISO 639 name/doc/row|hy}}
{{Template:ISO 639 name/doc/row|hz}}
{{Template:ISO 639 name/doc/row|ia}}
{{Template:ISO 639 name/doc/row|id}}
{{Template:ISO 639 name/doc/row|ie}}
{{Template:ISO 639 name/doc/row|ig}}
{{Template:ISO 639 name/doc/row|ii}}
{{Template:ISO 639 name/doc/row|ik}}
{{Template:ISO 639 name/doc/row|io}}
{{Template:ISO 639 name/doc/row|is}}
{{Template:ISO 639 name/doc/row|it}}
{{Template:ISO 639 name/doc/row|iu}}
{{Template:ISO 639 name/doc/row|ja}}
{{Template:ISO 639 name/doc/row|jv}}
{{Template:ISO 639 name/doc/row|ka}}
{{Template:ISO 639 name/doc/row|kg}}
{{Template:ISO 639 name/doc/row|ki}}
{{Template:ISO 639 name/doc/row|kj}}
{{Template:ISO 639 name/doc/row|kk}}
{{Template:ISO 639 name/doc/row|kl}}
{{Template:ISO 639 name/doc/row|km|khm}}
{{Template:ISO 639 name/doc/row|kn}}
{{Template:ISO 639 name/doc/row|ko}}
{{Template:ISO 639 name/doc/row|kr}}
{{Template:ISO 639 name/doc/row|ks}}
{{Template:ISO 639 name/doc/row|ku}}
{{Template:ISO 639 name/doc/row|kv}}
{{Template:ISO 639 name/doc/row|kw}}
{{Template:ISO 639 name/doc/row|ky}}
{{Template:ISO 639 name/doc/row|la}}
{{Template:ISO 639 name/doc/row|lb}}
{{Template:ISO 639 name/doc/row|lg}}
{{Template:ISO 639 name/doc/row|li}}
{{Template:ISO 639 name/doc/row|ln}}
{{Template:ISO 639 name/doc/row|lo}}
{{Template:ISO 639 name/doc/row|lt}}
{{Template:ISO 639 name/doc/row|lu}}
{{Template:ISO 639 name/doc/row|lv}}
{{Template:ISO 639 name/doc/row|mg}}
{{Template:ISO 639 name/doc/row|mh}}
{{Template:ISO 639 name/doc/row|mi}}
{{Template:ISO 639 name/doc/row|mk}}
{{Template:ISO 639 name/doc/row|ml}}
{{Template:ISO 639 name/doc/row|mn}}
{{Template:ISO 639 name/doc/row|mr}}
{{Template:ISO 639 name/doc/row|ms|msa|may}}
{{Template:ISO 639 name/doc/row|mt}}
{{Template:ISO 639 name/doc/row|my}}
{{Template:ISO 639 name/doc/row|na}}
{{Template:ISO 639 name/doc/row|nb}}
{{Template:ISO 639 name/doc/row|nd}}
{{Template:ISO 639 name/doc/row|ne|nep}}
{{Template:ISO 639 name/doc/row|ng}}
{{Template:ISO 639 name/doc/row|nl}}
{{Template:ISO 639 name/doc/row|nn}}
{{Template:ISO 639 name/doc/row|no}}
{{Template:ISO 639 name/doc/row|nr}}
{{Template:ISO 639 name/doc/row|nv}}
{{Template:ISO 639 name/doc/row|ny}}
{{Template:ISO 639 name/doc/row|oc}}
{{Template:ISO 639 name/doc/row|oj}}
{{Template:ISO 639 name/doc/row|om}}
{{Template:ISO 639 name/doc/row|or|ori}}
{{Template:ISO 639 name/doc/row|os}}
{{Template:ISO 639 name/doc/row|pa}}
{{Template:ISO 639 name/doc/row|pi}}
{{Template:ISO 639 name/doc/row|pl}}
{{Template:ISO 639 name/doc/row|ps}}
{{Template:ISO 639 name/doc/row|pt}}
{{Template:ISO 639 name/doc/row|qu}}
{{Template:ISO 639 name/doc/row|rm}}
{{Template:ISO 639 name/doc/row|rn}}
{{Template:ISO 639 name/doc/row|ro}}
{{Template:ISO 639 name/doc/row|ru}}
{{Template:ISO 639 name/doc/row|rw}}
{{Template:ISO 639 name/doc/row|sa}}
{{Template:ISO 639 name/doc/row|sc}}
{{Template:ISO 639 name/doc/row|sd}}
{{Template:ISO 639 name/doc/row|se}}
{{Template:ISO 639 name/doc/row|sg}}
{{Template:ISO 639 name/doc/row|sh|{{efn|name="not assigned"}}}}
{{Template:ISO 639 name/doc/row|si}}
{{Template:ISO 639 name/doc/row|sk}}
{{Template:ISO 639 name/doc/row|sl}}
{{Template:ISO 639 name/doc/row|sm}}
{{Template:ISO 639 name/doc/row|sn}}
{{Template:ISO 639 name/doc/row|so}}
{{Template:ISO 639 name/doc/row|sq}}
{{Template:ISO 639 name/doc/row|sr}}
{{Template:ISO 639 name/doc/row|ss}}
{{Template:ISO 639 name/doc/row|st|sot}}
{{Template:ISO 639 name/doc/row|su}}
{{Template:ISO 639 name/doc/row|sv}}
{{Template:ISO 639 name/doc/row|sw|swa}}
{{Template:ISO 639 name/doc/row|ta}}
{{Template:ISO 639 name/doc/row|te}}
{{Template:ISO 639 name/doc/row|tg}}
{{Template:ISO 639 name/doc/row|th}}
{{Template:ISO 639 name/doc/row|ti}}
{{Template:ISO 639 name/doc/row|tk}}
{{Template:ISO 639 name/doc/row|tl}}
{{Template:ISO 639 name/doc/row|tn}}
{{Template:ISO 639 name/doc/row|to}}
{{Template:ISO 639 name/doc/row|tr}}
{{Template:ISO 639 name/doc/row|ts}}
{{Template:ISO 639 name/doc/row|tt}}
{{Template:ISO 639 name/doc/row|tw}}
{{Template:ISO 639 name/doc/row|ty}}
{{Template:ISO 639 name/doc/row|ug}}
{{Template:ISO 639 name/doc/row|uk}}
{{Template:ISO 639 name/doc/row|ur}}
{{Template:ISO 639 name/doc/row|uz}}
{{Template:ISO 639 name/doc/row|ve}}
{{Template:ISO 639 name/doc/row|vi}}
{{Template:ISO 639 name/doc/row|vo}}
{{Template:ISO 639 name/doc/row|wa}}
{{Template:ISO 639 name/doc/row|wo}}
{{Template:ISO 639 name/doc/row|xh}}
{{Template:ISO 639 name/doc/row|yi}}
{{Template:ISO 639 name/doc/row|yo}}
{{Template:ISO 639 name/doc/row|za}}
{{Template:ISO 639 name/doc/row|zh}}
{{Template:ISO 639 name/doc/row|zu}}
|}

===Notes===
{{Notelist|refs=
{{efn|name="639-2B"|There are only 20 ISO 639-2B codes.}}
{{efn|name="not assigned"|Code not assigned.}}
}}

== Examples ==
* <code><nowiki>{{ISO 639 name|en}}</nowiki></code> gives {{ISO 639 name|en}}
* <code><nowiki>{{ISO 639 name|fr}}</nowiki></code> gives {{ISO 639 name|fr}}

==Error messages==
This template produces error messages.  These messages are:
*{{error-small|&lt;{{var|code}}> is an IETF tag}} – [[IETF language tag]]s are not ISO 639 language codes.  When these tags are encountered, the template attempts to render the correct language and also emits this error message
*{{error-small|ISO 639-&lt;{{var|part}}> code is required}} – where &lt;{{var|part}}> is 1, 2, 3, 5; template was called without the required language code
*{{error-small|&lt;{{var|code}}> is not an ISO 639-&lt;{{var|part}}> code}} – &lt;{{var|code}}> fails simple length validation; 639 part 1, language codes are two characters, for 639 parts 2, 3, and 5, language codes are three characters
*{{error-small|&lt;{{var|code}}> not found in ISO 639-&lt;{{var|part}}> list}} – &lt;{{var|code}}> not found after searching ISO 639-&lt;{{var|part}}> data

The module that does the work for this template has other functionality not supported by this template.  See [[Module:ISO 639 name]].  Error messages related to that other functionality are:
*{{error-small|language name required}} – module function <code>iso_639_name_to_code()</code> only – this message emitted when a language name is not provided in the <code><nowiki>{{#invoke:}}</nowiki></code>
*{{error-small|&lt;{{var|part}}> not an ISO 639 part}} – module functions <code>iso_639_name_to_code()</code> and <code>iso_639()</code> only – this message emitted when &lt;{{var|part}}> is not one of 1, 2, 3, or 5
*{{error-small|language code or name required}} – module function <code>iso_639()</code> only – this message emitted when a language name or a language code is not provided in the <code><nowiki>{{#invoke:}}</nowiki></code>

== Tracking categories ==
* {{Category link with count|ISO 639 name template errors}}

== See also ==
* [[:Category:Lang-x templates]]
* [[:Category:Lang-x templates with other than ISO 639]]
* [[:Category:Articles containing non-English-language text]]
* {{tl|lang}}
* {{tl|mw lang}}
* {{tl|language with name}}

<includeonly>{{Sandbox other||
[[Category:ISO 639 templates| ]]
[[Category:Language tag handling templates]]

}}</includeonly>