translit-ed

Translit-Ed

This package provides language-aware, standard-based transliteration for Cyrillic scripts:

---

Try transliteration on website →

---

Belarusian	Macedonian	Serbian
Bulgarian	Mongolian	Ukrainian
Kazakh	Russian	Uzbek

Installation

npm install translit-ed

Usage

import {
  cyrillicBelarusianToLatin,
  cyrillicBulgarianToLatin,
  cyrillicKazakhToLatin,
  cyrillicMacedonianToLatin,
  cyrillicMongolianToLatin,
  cyrillicRussianToLatin,
  cyrillicSerbianToLatin,
  cyrillicToLatinUnicode, // Universal transliteration function
  cyrillicUkrainianToLatin,
  cyrillicUzbekToLatin,
  ukrainianCyrillicToLatynka, // Two-way transliteration function
} from "translit-ed";

import {
  latinToCyrillicBelarusian,
  latinToCyrillicBulgarian,
  latinToCyrillicKazakh,
  latinToCyrillicMacedonian,
  latinToCyrillicMongolian,
  latinToCyrillicRussian,
  latinToCyrillicSerbian,
  latinToCyrillicUkrainian,
  latinToCyrillicUnicode, // Universal transliteration function
  latinToCyrillicUzbek,
  ukrainianLatynkaToCyrillic, // Two-way transliteration function
} from "translit-ed";

---

Examples

Belarusian (Cyrillic, national standard)

cyrillicBelarusianToLatin("Я і Юра ў Мінску.")
// Ja i Jura ŭ Minsku.
latinToCyrillicBelarusian("Ja i Jura ŭ Minsku.")
// Я і Юра ў Мінску.

Bulgarian (Cyrillic, BGN/PCGN 2013)

cyrillicBulgarianToLatin("Щъркелът е в ъгъла до гьола.")
// Shtarkelat e v agala do gyola.
latinToCyrillicBulgarian("Shtastie e v gyola.")
// Щастие е в гьола.

Kazakh (Cyrillic, BGN/PCGN 1979)

cyrillicKazakhToLatin("Әңгіме ғұрыппен қоңыр өгіз ұйықтап, үнімен һау деді.")
// Änggime ghuryppen qongyr ögiz uyyqtap, ünimen haū dedi.

Macedonian (Cyrillic, national standard)

cyrillicMacedonianToLatin("Ѓорѓи џвака ќебап со ѕвезда.")
// Gjorgji džvaka kjebap so dzvezda.
latinToCyrillicMacedonian("Kjutiot gjavol svira džez.")
// Ќутиот ѓавол свира џез.

Mongolian (Cyrillic, national standard)

cyrillicMongolianToLatin("Өндөр уул, үүлтэй өдөр.")
// Öndör uul, üültey ödör.
latinToCyrillicMongolian("Öndör üültey ödör.")
// Өндөр үүлтей өдөр.

Russian (Cyrillic, national standard)

cyrillicRussianToLatin("Съешь же ещё этих мягких французских булок, да выпей чаю.")
// S"yesh' zhe yeshchyo etikh myagkikh frantsuzskikh bulok, da vypey chayu.
latinToCyrillicRussian("S\"yesh' zhe yeshchyo etikh myagkikh frantsuzskikh bulok, da vypey chayu.")
// Съешь же ещё этих мягких французских булок, да выпей чаю.

Serbian (Cyrillic, national standard)

cyrillicSerbianToLatin("Љубав и џез.")
// Ljubav i džez.
latinToCyrillicSerbian("Njegova džez ploča.")
// Његова џез плоча.

Ukrainian (Cyrillic, national standard)

cyrillicUkrainianToLatin("Є юний їжак, ґудзик і гілка в яру.")
// Ye yunyi yizhak, gudzyk i hilka v yaru.
latinToCyrillicUkrainian("Ye yunyi yizhak, gudzyk i hilka v yaru.")
// Є юний їжак, ґудзик і гілка в яру.

Ukrainian (Cyrillic, Gajica (Гаєвиця) project)

Lossless or "two-way" transliteration – never lose any original characters.

ukrainianCyrillicToLatynka("Є юний їжак, ґудзик і гілка в яру.")
// "Je junyj jižak, gudzyk i hilka v jaru."
ukrainianLatynkaToCyrillic("Je junyj jižak, gudzyk i hilka v jaru.")
// "Є юний їжак, ґудзик і гілка в яру."

Uzbek (Cyrillic, national standard)

cyrillicUzbekToLatin("Ўзбекистонда қўшиқ ва ғазал.")
// O'zbekistonda qo'shiq va g'azal.
latinToCyrillicUzbek("G'oz va o'zbekcha so'z.")
// Ғоз ва ўзбекча сўз.

---

️ Functions

From	•	To
cyrillicBelarusianToLatin		latinToCyrillicBelarusian
cyrillicBulgarianToLatin		latinToCyrillicBulgarian
cyrillicKazakhToLatin		latinToCyrillicKazakh
cyrillicMacedonianToLatin		latinToCyrillicMacedonian
cyrillicMongolianToLatin		latinToCyrillicMongolian
cyrillicRussianToLatin		latinToCyrillicRussian
cyrillicSerbianToLatin		latinToCyrillicSerbian
cyrillicUkrainianToLatin		latinToCyrillicUkrainian
ukrainianCyrillicToLatynka		ukrainianLatynkaToCyrillic
cyrillicUzbekToLatin		latinToCyrillicUzbek
cyrillicToLatinUnicode		latinToCyrillicUnicode

CLI Usage

You can use translit-ed via command line with npx:

npx translit-ed -unicode-cyr2lat "Текст на български"
# `Tekst na b"lgarski`

npx translit-ed -ru-cyr2lat "Текст на русском"
# `Tekst na russkom`

npx translit-ed -ua-gajica-cyr2lat "Текст Українською Гаєвиця"
# `Tekst Ukrajinsjkoju Hajevycja`

Run npx translit-ed without arguments to see all available flags.

License

MIT