Template:ISO 639 name/doc

Usage

The {{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 tags to just the ISO 639 code. E.g.: Sanskrit in Latin script, which IETF language tag is sa-Latn, renders as:

• {{ISO 639 name|sa-Latn}} → Sanskrit

The error message can be suppressed with |hide-err=yes:

• {{ISO 639 name|sa-Latn|hide-err=yes}} → Sanskrit

The rendered language name can be linked to the appropriate language article with |link=yes:

• {{ISO 639 name|sa-Latn|hide-err=yes|link=yes}} → Sanskrit

When linking, an alternate link label can be provided with |label=<label text>:

• {{ISO 639 name|sa-Latn|hide-err=yes|link=yes|label=sa-Latn}} → sa-Latn

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

Both of these templates 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:

• iso_639_code_exists – returns true if <code> is found in any of the ISO 639 data tables
• iso_639_code_to_name – (default) as described above
• iso_639_code_1_to_name – same as iso_639_code_to_name except constrained to the ISO 639-1 data table
• iso_639_code_2_to_name – same as iso_639_code_to_name except constrained to the ISO 639-2 data table
• iso_639_code_2B_to_name – same as iso_639_code_to_name except constrained to the ISO 639-2B data table
• iso_639_code_3_to_name – same as iso_639_code_to_name except constrained to the ISO 639-3 data table
• iso_639_code_5_to_name – same as iso_639_code_to_name except constrained to the ISO 639-5 data table
• iso_639_name_exists – returns true if <name> is found in any of the ISO 639 data tables
• iso_639_name_to_code – returns language code associated with <name>; may be constrained to a particular ISO 639 data table
• iso_639 – 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 |fn= to the appropriate function name.

Language codes

ISO 639-1 codes and matching codes from ISO 639-2, -2B, and -3

ISO 639-1	ISO 639-2	ISO 639-2B	ISO 639-3	Name	Article
aa	aar		aar	Afar	Afar
ab	abk		abk	Abkhazian	Abkhazian
ae	ave		ave	Avestan	Avestan
af	afr		afr	Afrikaans	Afrikaans
ak	aka		aka	Akan	Akan
am	amh		amh	Amharic	Amharic
an	arg		arg	Aragonese	Aragonese
ar	ara		ara	Arabic	Arabic
as	asm		asm	Assamese	Assamese
av	ava		ava	Avaric	Avaric
ay	aym		aym	Aymara	Aymara
az	aze		aze	Azerbaijani	Azerbaijani
ba	bak		bak	Bashkir	Bashkir
be	bel		bel	Belarusian	Belarusian
bg	bul		bul	Bulgarian	Bulgarian
bh	bih			Bihari languages	Bihari languages
bi	bis		bis	Bislama	Bislama
bm	bam		bam	Bambara	Bambara
bn	ben		ben	Bengali	Bengali
bo	bod	tib	bod	Standard Tibetan	Standard Tibetan
br	bre		bre	Breton	Breton
bs	bos		bos	Bosnian	Bosnian
ca	cat		cat	Catalan	Catalan
ce	che		che	Chechen	Chechen
ch	cha		cha	Chamorro	Chamorro
co	cos		cos	Corsican	Corsican
cr	cre		cre	Cree	Cree
cs	ces	cze	ces	Czech	Czech
cu	chu		chu	Church Slavic	Church Slavic
cv	chv		chv	Chuvash	Chuvash
cy	cym	wel	cym	Welsh	Welsh
da	dan		dan	Danish	Danish
de	deu	ger	deu	German	German
dv	div		div	Dhivehi	Dhivehi
dz	dzo		dzo	Dzongkha	Dzongkha
ee	ewe		ewe	Ewe	Ewe
el	ell	gre	ell	Greek	Greek
en	eng		eng	English	English
eo	epo		epo	Esperanto	Esperanto
es	spa		spa	Spanish	Spanish
et	est		est	Estonian	Estonian
eu	eus	baq	eus	Basque	Basque
fa	fas	per	fas	Persian	Persian
ff	ful		ful	Fulah	Fulah
fi	fin		fin	Finnish	Finnish
fj	fij		fij	Fijian	Fijian
fo	fao		fao	Faroese	Faroese
fr	fra	fre	fra	French	French
fy	fry		fry	Western Frisian	Western Frisian
ga	gle		gle	Irish	Irish
gd	gla		gla	Scottish Gaelic	Scottish Gaelic
gl	glg		glg	Galician	Galician
gn	grn		grn	Guarani	Guarani
gu	guj		guj	Gujarati	Gujarati
gv	glv		glv	Manx	Manx
ha	hau		hau	Hausa	Hausa
he	heb		heb	Hebrew	Hebrew
hi	hin		hin	Hindi	Hindi
ho	hmo		hmo	Hiri Motu	Hiri Motu
hr	hrv	scr	hrv	Croatian	Croatian
ht	hat		hat	Haitian Creole	Haitian Creole
hu	hun		hun	Hungarian	Hungarian
hy	hye	arm	hye	Armenian	Armenian
hz	her		her	Herero	Herero
ia	ina		ina	Interlingua	Interlingua
id	ind		ind	Indonesian	Indonesian
ie	ile		ile	Interlingue	Interlingue
ig	ibo		ibo	Igbo	Igbo
ii	iii		iii	Sichuan Yi	Sichuan Yi
ik	ipk		ipk	Inupiaq	Inupiaq
io	ido		ido	Ido	Ido
is	isl	ice	isl	Icelandic	Icelandic
it	ita		ita	Italian	Italian
iu	iku		iku	Inuktitut	Inuktitut
ja	jpn		jpn	Japanese	Japanese
jv	jav	jaw	jav	Javanese	Javanese
ka	kat	geo	kat	Georgian	Georgian
kg	kon		kon	Kongo	Kongo
ki	kik		kik	Kikuyu	Kikuyu
kj	kua		kua	Kuanyama	Kuanyama
kk	kaz		kaz	Kazakh	Kazakh
kl	kal		kal	Kalaallisut	Kalaallisut
km	khm		khm	Khmer	Khmer
kn	kan		kan	Kannada	Kannada
ko	kor		kor	Korean	Korean
kr	kau		kau	Kanuri	Kanuri
ks	kas		kas	Kashmiri	Kashmiri
ku	kur		kur	Kurdish	Kurdish
kv	kom		kom	Komi	Komi
kw	cor		cor	Cornish	Cornish
ky	kir		kir	Kirghiz	Kirghiz
la	lat		lat	Latin	Latin
lb	ltz		ltz	Luxembourgish	Luxembourgish
lg	lug		lug	Ganda	Ganda
li	lim		lim	Limburgan	Limburgan
ln	lin		lin	Lingala	Lingala
lo	lao		lao	Lao	Lao
lt	lit		lit	Lithuanian	Lithuanian
lu	lub		lub	Luba-Katanga	Luba-Katanga
lv	lav		lav	Latvian	Latvian
mg	mlg		mlg	Malagasy	Malagasy
mh	mah		mah	Marshallese	Marshallese
mi	mri	mao	mri	Maori	Maori
mk	mkd	mac	mkd	Macedonian	Macedonian
ml	mal		mal	Malayalam	Malayalam
mn	mon		mon	Mongolian	Mongolian
mr	mar		mar	Marathi	Marathi
ms	msa	may	msa	Malay	Malay
mt	mlt		mlt	Maltese	Maltese
my	mya	bur	mya	Burmese	Burmese
na	nau		nau	Nauru	Nauru
nb	nob		nob	Norwegian Bokmål	Norwegian Bokmål
nd	nde		nde	North Ndebele	North Ndebele
ne	nep		nep	Nepali	Nepali
ng	ndo		ndo	Ndonga	Ndonga
nl	nld	dut	nld	Dutch	Dutch
nn	nno		nno	Norwegian Nynorsk	Norwegian Nynorsk
no	nor		nor	Norwegian	Norwegian
nr	nbl		nbl	South Ndebele	South Ndebele
nv	nav		nav	Navajo	Navajo
ny	nya		nya	Nyanja	Nyanja
oc	oci		oci	Occitan	Occitan
oj	oji		oji	Ojibwa	Ojibwa
om	orm		orm	Oromo	Oromo
or	ori		ori	Oriya	Oriya
os	oss		oss	Ossetian	Ossetian
pa	pan		pan	Panjabi	Panjabi
pi	pli		pli	Pali	Pali
pl	pol
ps
pt
qu
rm
rn
ro
ru
rw
sa
sc
sd
se
sg
sh
si
sk
sl
sm
sn
so
sq
sr
ss
st	sot
su
sv
sw	swa
ta
te
tg
th
ti
tk
tl
tn
to
tr
ts
tt
tw
ty
ug
uk
ur
uz
ve
vi
vo
wa
wo
xh
yi
yo
za
zh
zu

Examples

• {{ISO 639 name|en}} gives
• {{ISO 639 name|fr}} gives

Error messages

This template produces error messages. These messages are:

• – IETF language tags 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
• – where <part> is 1, 2, 3, 5; template was called without the required language code
• – <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
• – <code> not found after searching ISO 639-<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:

• – module function iso_639_name_to_code() only – this message emitted when a language name is not provided in the {{#invoke:}}
• – module functions iso_639_name_to_code() and iso_639() only – this message emitted when <part> is not one of 1, 2, 3, or 5
• – module function iso_639() only – this message emitted when a language name or a language code is not provided in the {{#invoke:}}

Tracking categories

• [[:Category:|Category:]] (0)

See also

• Category:Lang-x templates
• Category:Lang-x templates with other than ISO 639
• Category:Articles containing non-English-language text
• {{lang}}
• {{Language with name}}