Module:ISO 639 name/doc

MyWikiBiz, Author Your Legacy — Sunday December 29, 2024
Jump to navigationJump to search

This is the documentation page for Module:ISO 639 name

Template:Lua Template:High-use

Module:ISO 639 name implements:


Data mapping

For code-to-name mapping, this module uses data from:

For name-to-code mapping, this module uses data from:

Testcases

Tracking categories

iso_639_code_exists

Returns true when <Template:Var> is found in one of the ISO 639-1, -2, -3, -5, or override tables; returns nil else.

Useage:

{{#invoke:ISO 639 name|iso_639_code_exists|<Template:Var>}}

Examples:

without required <Template:Var>:
{{#invoke:ISO 639 name|iso_639_code_exists}}
with valid <Template:Var>:
{{#invoke:ISO 639 name|iso_639_code_exists|nav}} → true
with invalid <Template:Var>:
{{#invoke:ISO 639 name|iso_639_code_exists|xx}}

iso_639_code_to_name

Returns language name associated with <Template:Var>. May return an error message with or without a language name.

Optional parameters:

Template:Para: suppresses error messages
Template:Para: creates link to en.wiki article about the language
Template:Para – requires Template:Para; label for the language-name link: [[<Template:Var> language|<Template:Var>]]
Template:Para: queries part tables only; returns language name as defined in the base data tables without the removal of disambiguation information

Examples:

without required <Template:Var>:
{{#invoke:ISO 639 name|iso_639_code_to_name}}error: ISO 639 code is required (help)
with valid <Template:Var>:
{{#invoke:ISO 639 name|iso_639_code_to_name|nav}} → Navajo
with invalid <Template:Var>:
{{#invoke:ISO 639 name|iso_639_code_to_name|xx}}error: xx not found in ISO 639-1, -2, -2B, -3, -5 list (help)
with invalid <Template:Var> (IETF language tag):
{{#invoke:ISO 639 name|iso_639_code_to_name|nv-Latn}} → Navajo error: nv-Latn is an IETF tag (help)
with invalid <Template:Var>, error message suppressed:
{{#invoke:ISO 639 name|iso_639_code_to_name|nv-Latn|hide-err=yes}} → Navajo
linked:
{{#invoke:ISO 639 name|iso_639_code_to_name|nav|link=yes}}Navajo
linked with alternate spelling:
{{#invoke:ISO 639 name|iso_639_code_to_name|nav|link=yes|label=Navaho}}Navaho
ISO 639-1 code el is normally overridden by a setting in Module:Language/data/ISO_639_override:
{{#invoke:ISO 639 name|iso_639_code_to_name|el}} → Greek
ISO 639-1 code el with override suppressed:
{{#invoke:ISO 639 name|iso_639_code_to_name|el|raw=yes}} → Modern Greek (1453-)
ISO 639-3 code ina name has disambiguation that is normally suppressed:
{{#invoke:ISO 639 name|iso_639_code_to_name|ina}} → Interlingua
ISO 639-3 code ina with disambiguation:
{{#invoke:ISO 639 name|iso_639_code_to_name|ina|raw=yes}} → Interlingua (International Auxiliary Language Association)

iso_639_code_1_to_name

Same as iso_639_code_to_name except that <Template:Var> must be an ISO 639-1 code; search is constrained to Module:Language/data/ISO 639 override and Module:Language/data/ISO 639-1.

Example:

with valid <Template:Var>:
{{#invoke:ISO 639 name|iso_639_code_1_to_name|nv}} → Navajo
with invalid <Template:Var>:
{{#invoke:ISO 639 name|iso_639_code_1_to_name|xx}}error: xx not found in ISO 639-1 list (help)

iso_639_code_2_to_name

Same as iso_639_code_to_name except that <Template:Var> must be an ISO 639-2 code; search is constrained to Module:Language/data/ISO 639 override and Module:Language/data/ISO 639-2.

Example:

with valid <Template:Var>:
{{#invoke:ISO 639 name|iso_639_code_2_to_name|apa}} → Apache languages
with invalid <Template:Var>:
{{#invoke:ISO 639 name|iso_639_code_2_to_name|xxx}}error: xxx not found in ISO 639-2 list (help)

iso_639_code_2B_to_name

Same as iso_639_code_to_name except that <Template:Var> must be an ISO 639-2B code; search is constrained to Module:Language/data/ISO 639 override and Module:Language/data/ISO 639-2B.

Example:

with valid <Template:Var>:
{{#invoke:ISO 639 name|iso_639_code_2B_to_name|ice}} → Icelandic
with invalid <Template:Var>:
{{#invoke:ISO 639 name|iso_639_code_2B_to_name|xxx}}error: xxx not found in ISO 639-2B list (help)

iso_639_code_3_to_name

Same as iso_639_code_to_name except that <Template:Var> must be an ISO 639-3 code; search is constrained to Module:Language/data/ISO 639 override and Module:Language/data/ISO 639-3.

Example:

with valid <Template:Var>:
{{#invoke:ISO 639 name|iso_639_code_3_to_name|nav}} → Navaho
with invalid <Template:Var>:
{{#invoke:ISO 639 name|iso_639_code_3_to_name|xxx}}error: xxx not found in ISO 639-3 list (help)

iso_639_code_5_to_name

Same as iso_639_code_to_name except that <Template:Var> must be an ISO 639-5 code; search is constrained to Module:Language/data/ISO 639 override and Module:Language/data/ISO 639-5.

Example:

with valid <Template:Var>:
{{#invoke:ISO 639 name|iso_639_code_5_to_name|apa}} → Apache languages
with invalid <Template:Var>:
{{#invoke:ISO 639 name|iso_639_code_5_to_name|xxx}}error: xxx not found in ISO 639-5 list (help)

iso_639_name_exists

Returns true when <Template:Var> is found in one of the ISO 639-1, -2, -3, -5, or override tables; returns nil else.

Useage:

{{#invoke:ISO 639 name|iso_639_name_exists|<Template:Var>}}

Examples:

without required <Template:Var>:
{{#invoke:ISO 639 name|iso_639_name_exists}}
with valid <Template:Var>:
{{#invoke:ISO 639 name|iso_639_name_exists|french}} → true
with invalid <Template:Var>:
{{#invoke:ISO 639 name|iso_639_name_exists|fr}}

iso_639_name_to_code

Returns ISO 639 language code associated with <Template:Var>. May return an error message with or without a language name.

This function may not be particularly useful because, except for case, <Template:Var> must exactly match the name in the data tables.

Optional parameters:

<Template:Var> (second positional parameter) – limits return to codes from the specified <Template:Var> (1, 2, 3, 5), override table first then the appropriate data table; when not supplied, this function searches in order part 1 to part 5. The search stops when a match is found.
Template:Para: suppresses error messages

Examples:

without <Template:Var>, with ISO 639-5 name:
{{#invoke:ISO 639 name|iso_639_name_to_code|North Germanic languages}} → gmq
with <Template:Var>:
{{#invoke:ISO 639 name|iso_639_name_to_code|Navajo|2}} → nav

iso_639

When given an ISO 639 language code, return the associated language name; when given a language name, returns the associated ISO 639 language code. May return an error message with or without a language code/name.

This function may not be particularly useful because, except for case, a provided <Template:Var> must exactly match the name in the data tables.

Optional parameters:

<Template:Var> (second positional parameter) – limits return to codes/names from the specified <Template:Var> (1, 2, 3, 5), override table first then the appropriate data table; when not supplied, this function searches in order part 1 to part 5. The search stops when a match is found.
Template:Para: suppresses error messages

Examples:

without <Template:Var>, with ISO 639-5 code:
{{#invoke:ISO 639 name|iso_639|gmq}} → North Germanic languages
without <Template:Var>, with ISO 639-5 name:
{{#invoke:ISO 639 name|iso_639|North Germanic languages}} → gmq
with <Template:Var> and <Template:Var>:
{{#invoke:ISO 639 name|iso_639|nav|2}} → Navajo
with <Template:Var> and <Template:Var>:
{{#invoke:ISO 639 name|iso_639|Navaho|2}} → nav