hangul-romanize is a Python library for romanizing Hangul strings, specifically adhering to the academic notation rules (국립국어원 학술 표기법) of the National Institute of Korean Language. As of version 0.1.0, it provides tools for converting Korean text into the Latin alphabet based on these scholarly guidelines.
pip install hangul-romanizeVerified import paths — ran on the pinned version, not inferred.
This quickstart demonstrates how to import the `Transliter` class and the `academic` rule set, then use them to romanize Korean Hangul strings. It prints the original and romanized text.
Consult the official documentation for the specific academic rules implemented by the library to understand its behavior. If 'Revised Romanization' is strictly required, consider alternative libraries or custom post-processing.
Understand that romanization is an approximation. For precise pronunciation, direct study of Hangul and Korean phonology is recommended. Do not rely solely on romanization for learning correct pronunciation.
Verify compatibility with your current Python environment and review GitHub issues for any unaddressed bugs or feature requests. For long-term projects, consider the maintenance status.
Run `pip install hangul-romanize` to install the library.
You must first import and instantiate the `Transliter` class, then call its `translit` method: `from hangul_romanize import Transliter; from hangul_romanize.rule import academic; transliter = Transliter(academic); romanized = transliter.translit('안녕하세요')`.Review the `hangul-romanize` GitHub repository and documentation to understand the precise academic rules it implements. If a different romanization standard is desired, consider using an alternative library or implementing custom mapping rules.
No dependency data recorded yet.