Installations
npm install @diotoborg/beatae-illo
Developer Guide
Typescript
No
Module System
CommonJS
Node Version
20.17.0
NPM Version
10.8.2
Releases
Contributors
Unable to fetch Contributors
Languages
JavaScript (100%)
Developer
diotoborg
Download Statistics
Total Downloads
2
Last Day
1
Last Week
1
Last Month
2
Last Year
2
GitHub Statistics
2,275 Commits
1 Watching
1 Branches
1 Contributors
Package Meta Information
Latest Version
4.12.106
Package Id
@diotoborg/beatae-illo@4.12.106
Unpacked Size
215.02 kB
Size
111.15 kB
File Count
578
NPM Version
10.8.2
Node Version
20.17.0
Publised On
22 Sept 2024
Total Downloads
Cumulative downloads
Total Downloads
2
Last day
0%
1
Compared to previous day
Last week
0%
1
Compared to previous week
Last month
0%
2
Compared to previous month
Last year
0%
2
Compared to previous year
Daily Downloads
Weekly Downloads
Monthly Downloads
Yearly Downloads
Dependencies
29
i18n-iso-languages
i18n for ISO 639 language codes. We support Alpha-2, Alpha-3 B and T codes from https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes
This packages is heavily based on i18n-iso-countries.
We intent to keep the interface of i18n-iso-languages as close as possible to i18n-iso-countries.
Installing
Install it using npm: npm install @diotoborg/beatae-illo
If used in a browser environment, you will need to manually install the local you wish to support.
1var languages = require("@diotoborg/beatae-illo"); 2 3// Support german & english languages. 4languages.registerLocale(require("@diotoborg/beatae-illo/langs/en.json")); 5languages.registerLocale(require("@diotoborg/beatae-illo/langs/de.json"));
Code to Language
Get the name of a language by it's ISO 639-1 (Alpha-2), ISO 639-2/T or B (Alpha-3) code
1var languages = require("@diotoborg/beatae-illo"); 2console.log("de (639-1/Alpha-2) => " + languages.getName("de", "en")); // German 3console.log("en (639-1/Alpha-2) => " + languages.getName("de", "de")); // Deutsch 4console.log("de (639-2T/Alpha-3) => " + languages.getName("deu", "en")); // German 5console.log("de (639-2B/Alpha-3) => " + languages.getName("ger", "en")); // German
Get all names by their ISO 639-1 code
1var languages = require("@diotoborg/beatae-illo"); 2console.log(languages.getNames("en")); // { 'ab': 'Abkhazian', 'aa': 'Afar', [...], 'za': 'Zhuang', 'zu': 'Zulu' }
Supported languages (ISO 639-1)
ar
: Arabic (based on https://github.com/umpirsky/language-list/blob/master/data/ar/language.json)bg
: Bulgarian (based on https://bg.wikipedia.org/wiki/Кодове_на_езици with minor adjustments)br
: Breton (based on https://br.wikipedia.org/wiki/Listenn_glok_kodoù_ISO_639-1)cs
: Czech (based on https://cs.wikipedia.org/wiki/Seznam_kódů_ISO_639-1)da
: Danish (based on https://da.wikipedia.org/wiki/ISO_639-1)de
: German (by native speaker)en
: English (ISO 639-1 standard names)es
: Spanish (based on https://es.wikipedia.org/wiki/ISO_639-1)fi
: Finnish (based on https://kotoistus.fi/suositukset/suositukset-kielet-fi-koodi/)fr
: French (based on https://fr.wikipedia.org/wiki/Liste_des_codes_ISO_639-1)he
: Hebrew (based on ECMAScript Internationalization API data)hu
: Hungarian (based on https://hu.wikipedia.org/wiki/ISO_639-1_nyelvkódok_listája)id
: Indonesian (based on https://github.com/umpirsky/language-list/blob/master/data/id/language.json)is
: Islandic (based on https://is.wikipedia.org/wiki/Listi_yfir_tungumálakóða_%C3%AD_ISO_639-1)it
: Italian (based on https://github.com/umpirsky/language-list/blob/master/data/it/language.json)ja
: Japanese (by professional translator)ko
: Korean (based on https://github.com/umpirsky/language-list/blob/master/data/ko/language.json)lt
: Lithuanian (based on https://lt.wikipedia.org/wiki/Sąrašas:ISO_639-1_kodai)lv
: Latvian (based on https://lv.wikipedia.org/wiki/ISO_639-1_kodu_saraksts)ms
: Malay (based on https://github.com/umpirsky/language-list/blob/master/data/ms/language.json)nl
: Dutch (based on https://nl.wikipedia.org/wiki/Lijst_van_ISO_639-codes)no
: Norwegian (based on https://no.wikipedia.org/wiki/Liste_over_ISO_639-1-koder)pl
: Polish (based on https://pl.wiktionary.org/wiki/Wikis%C5%82ownik:Kody_j%C4%99zyk%C3%B3w)pt
: Portuguese (European) (based on https://pt.wikipedia.org/wiki/ISO_639)ro
: Romanian (based on https://ro.wikipedia.org/wiki/Lista_codurilor_ISO_639-1)ru
: Russian (by professional translator)sk
: Slovak (based on https://sk.wikipedia.org/wiki/ISO_639)sv
: Swedish (based on https://sv.wikipedia.org/wiki/ISO_639)th
: Thai (based on https://github.com/umpirsky/language-list/blob/master/data/th/language.json)uk
: Ukrainian (based on https://uk.wikipedia.org/wiki/Список_мовних_кодів_ISO_639)vi
: Vietnamese (based on https://github.com/umpirsky/language-list/blob/master/data/vi/language.json)zh
: Chinese (by professional translator)
Language to Code
1var languages = require("@diotoborg/beatae-illo"); 2console.log("German => " + languages.getAlpha2Code('German', 'en')); 3// German => de 4 5console.log("German => " + languages.getAlpha3TCode('German', 'en')); 6// German => deu 7 8console.log("German => " + languages.getAlpha3BCode('German', 'en')); 9// German => ger
Codes
Convert ISO 639-2 (Alpha-3) to ISO 639-1 (Alpha-2) code
1var languages = require("@diotoborg/beatae-illo"); 2console.log("deu (Alpha-3) => " + languages.alpha3ToAlpha2("deu") + " (Alpha-2)"); 3// deu (Alpha-3 T) => de (Alpha-2) 4 5var languages = require("@diotoborg/beatae-illo"); 6console.log("ger (Alpha-3 B) => " + languages.alpha3ToAlpha2("ger") + " (Alpha-2)"); 7// ger (Alpha-3 B) => de (Alpha-2)
Convert ISO 639-1 (Alpha-2) to ISO 639-2 (Alpha-3) code
1var languages = require("@diotoborg/beatae-illo"); 2console.log("de (Alpha-2) => " + languages.alpha2ToAlpha3T("de") + " (Alpha-3 T)"); 3// de (Alpha-2) => deu (Alpha-3 T) 4 5var languages = require("@diotoborg/beatae-illo"); 6console.log("de (Alpha-2) => " + languages.alpha2ToAlpha3B("de") + " (Alpha-3 B)"); 7// de (Alpha-2) => ger (Alpha-3 B)
Get all ISO 639-1 (Alpha-2) codes
1var languages = require("@diotoborg/beatae-illo"); 2console.log(languages.getAlpha2Codes()); 3// { 'aa': 'aar', 'ab': 'abk', [...], 'za': 'zha', 'zu': 'zul' }
Get all ISO 639-2 (Alpha-3) codes
1var languages = require("@diotoborg/beatae-illo"); 2console.log(languages.getAlpha3TCodes()); 3// { 'aar': 'aa', 'abk': 'ab', [...], 'zha': 'za', 'zul': 'zu' } 4 5var languages = require("@diotoborg/beatae-illo"); 6console.log(languages.getAlpha3BCodes()); 7// { 'aar': 'aa', 'abk': 'ab', [...], 'zha': 'za', 'zul': 'zu' }
Validate language code
1var languages = require("@diotoborg/beatae-illo"); 2console.log(languages.isValid("de"), languages.isValid("ger"), languages.isValid("xx"))); 3// true, true, false
Contribution
To add a language:
- add a json file under langs/ (in alphabetical order)
- add the language to the
data
object in enty-node.js at the top (in alphabetical order) - add language to section Supported languages in README.md (in alphabetical order)
- add language to keywords in package.json (in alphabetical order)
- add language to the "unreleased" section of the changelog
- run
npm install && make test
to make sure that tests are passing - open a PR on GitHub
Please do not change the version in package.json, package-lock.json or changelog.md.
No vulnerabilities found.
No security vulnerabilities found.