ISO 639-1/2/3 Language codes with English and local names
npm install langs-es
shell
$ npm i langs-es
`
What's with all the ISO version numbers?
ISO 639 is broken up into many different parts, each either defining language
codes or defining standards for codes in later versions. The ones included in
this library are:
- ISO 639-1 2 characters, one per language or [ISO 639 macrolanguage][wiki-macro]
- ISO 639-2/2T 3 characters, one per language
- ISO 639-2B 3 characters, mostly the same as 639-2T but with some derived from their English name rather than local name
- ISO 639-3 3 characters, mostly the same as 639-2T but using the canonical ISO 639 macrolanguage code
The macrolanguages described above cover cases where a language is considered
to be a dialect of another in some standards but not in others, e.g Standard
Arabic arb and Arabic ara. There's more information on the
[Wikipedia page][wiki-macro].
Usage
`js
import langs from 'langs-es';
/ -or- /
/ const langs = require('langs-es'); /
langs.all();
// [
// { name: 'English', local: 'English', '1': 'en', '2': 'eng', 2T: 'eng', 2B: 'eng',
// '3': 'eng', invertedName: 'English', refName: 'English', scope: 'I', type: 'L' },
// { name: 'Korean', local: '한국어', '1': 'ko', '2': 'kor', 2T: 'kor', 2B: 'kor',
// '3': 'kor', invertedName: 'Korean', refName: 'Korean', scope: 'I', type: 'L' },
// ...
// ]
langs.names();
// [
// 'English',
// 'Korean',
// ...
// ]
langs.names(true);
// [
// 'English',
// '한국어',
// ...
// ]
langs.codes('1');
// [
// 'en',
// 'ko',
// ...
// ]
langs.codes('2T' /same as '2'/);
// [
// 'eng',
// 'kor',
// ...
// ]
langs.codes('2B');
// [
// 'eng',
// 'kor',
// ...
// ]
langs.codes('3');
// [
// 'eng',
// 'kor',
// ...
// ]
langs.where('name', 'Korean');
// { name: 'Korean', local: '한국어', '1': 'ko', '2': 'kor', 2T: 'kor', 2B: 'kor',
// '3': 'kor', invertedName: 'Korean', refName: 'Korean', scope: 'I', type: 'L' }
langs.where('local', '한국어, 조선어');
// { name: 'Korean', local: '한국어', '1': 'ko', '2': 'kor', 2T: 'kor', 2B: 'kor',
// '3': 'kor', invertedName: 'Korean', refName: 'Korean', scope: 'I', type: 'L' }
langs.where('1', 'ko');
// { name: 'Korean', local: '한국어', '1': 'ko', '2': 'kor', 2T: 'kor', 2B: 'kor',
// '3': 'kor', invertedName: 'Korean', refName: 'Korean', scope: 'I', type: 'L' }
langs.where('2', 'kor');
// { name: 'Korean', local: '한국어', '1': 'ko', '2': 'kor', 2T: 'kor', 2B: 'kor',
// '3': 'kor', invertedName: 'Korean', refName: 'Korean', scope: 'I', type: 'L' }
langs.where('2T', 'kor');
// { name: 'Korean', local: '한국어', '1': 'ko', '2': 'kor', 2T: 'kor', 2B: 'kor',
// '3': 'kor', invertedName: 'Korean', refName: 'Korean', scope: 'I', type: 'L' }
langs.where('2B', 'kor');
// { name: 'Korean', local: '한국어', '1': 'ko', '2': 'kor', 2T: 'kor', 2B: 'kor',
// '3': 'kor', invertedName: 'Korean', refName: 'Korean', scope: 'I', type: 'L' }
langs.where('3', 'kor');
// { name: 'Korean', local: '한국어', '1': 'ko', '2': 'kor', 2T: 'kor', 2B: 'kor',
// '3': 'kor', invertedName: 'Korean', refName: 'Korean', scope: 'I', type: 'L' }
langs.has('name', 'Korean');
// true
langs.has('local', '한국어, 조선어');
// true
langs.has('1', 'ko');
// true
langs.has('2', 'kor');
// true
langs.has('2T', 'kor');
// true
langs.has('2B', 'kor');
// true
langs.has('3', 'kor');
// true
langs.has('name', 'Geordie');
// false
langs.has('high', 'fives');
// false
`
Contributing
Contributions are welcome via pull request on [github][langs-es-git]. Please run unit
tests and linter locally prior to submitting your pull request.
`bash
git clone git@github.com:zxanderh/langs-es.git
cd ./langs-es
npm i
make your changes
npm lint
npm run build
npm test
`
$3
The file containing all of the language code data is automatically generated using
tables downloaded from the official ISO-639-3 website.
These tables do not change often, but when they do, a new data file can be generated
with npm run generate.
By default, the generator will save the tables to be reused in future runs. To force
the generator to download fresh copies of the tables, use npm run generate --- --fetch.
License
The content of this library is released under the MIT License by
Zane Huston (forked from package by Andrew Lawson).
You can find a copy of this license in
[LICENSE`][license] or at http://www.opensource.org/licenses/mit.