Skip to content

zaeleus/hangeul

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

36 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

hangeul

hanguel is a Korean romanization library. It implements transcription rules based on standard pronunciation specified by the National Institute of Korean Language.

Usage

lib

use hangeul::romanize;

assert_eq!(romanize("우주소녀"), "ujusonyeo");
assert_eq!(romanize("러블리즈"), "reobeullijeu");
assert_eq!(romanize("에이핑크"), "eipingkeu");

bin

$ hangeul <input>

Definitions

A syllable is a precomposed cluster of positional jamos, or letters: an initial consonant (choseong), a medial vowel (jungseong), and an optional final consonant (jongseong).

Romanization is the conversion from one script to Roman, or Latin, script. Two common methods are transliteration and transcription. Transliteration maps characters from the source script to the target. Transcription typically uses pronunciation rules from the source language to approximate how it would sound in the target language.

Limitations

  • Compound words are treated as single words, e.g., "마지막처럼" => "majimakcheoreom".

  • Proper nouns with administrative units are neither capitalized nor hypenated, e.g., "제주도" => "jejudo" (expected: "Jeju-do").

  • Names are neither capitalized nor spaced, e.g., "김세정" => "gimsejeong" (expected: "Gim Se Jeong"). Note that names still commonly use McCune-Reischauer romanization and other de facto rules over Revised Romanization (see also "Discussion of Surname Romanization"). The previous example would more likely be "Kim Se Jeong" or "Kim Se Jung".

Resources

About

Korean romanization using transcription

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages