Skip to main content

Convert Korean people's Hangul names to romanized versions

Project description

Pipeline status Coverage Korean script (Hangul) has used various notations over the years to be converted to latin (Roman) characters. The currently used official system for normal words is Revised Romanization (RR), which eliminated ambiguity in the old system McCune–Reischauer (McR). McR uses accented characters to denote differences in pronounciation. Accented characters were commonly not used in internet communications as they are hard to type and/or not well supported in fonts. Over the years font support has improved tremendously, but keyboard support is still flunky.

The lack of accents caused ambiguity in romanized words and people had to guess from the context what the writer meant (yo and were both spelled as yo). The Revised Romanization system uses plain characters from the ASCII range to denote the differences in pronounciation for example through the use of multi-letter vowels (yeo instead of ).

However, for people’s names (famous or not), the rules are bent, because people are used to a certain romanization of their name and have traditionally not strictly adhered to one system or another. The classical example is that the surname is always romanized to Kim, whereas RR dictates Gim.

This library contains a set of rules that can be implemented to deviate from RR notation using transliteration definitions and succession rules. It was inspired by the author’s work on Dramawiki, which uses a documented set of prefences, so that people with the same name in Hangul script, end up romanized exactly the same. Since Dramawiki aims to support English readers it didn’t make sense to create pages with titles written in Hangul.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

hangul-names-0.4.2.tar.gz (9.6 kB view details)

Uploaded Source

Built Distribution

hangul_names-0.4.2-py3-none-any.whl (9.2 kB view details)

Uploaded Python 3

File details

Details for the file hangul-names-0.4.2.tar.gz.

File metadata

  • Download URL: hangul-names-0.4.2.tar.gz
  • Upload date:
  • Size: 9.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.2.0 requests-toolbelt/0.9.1 tqdm/4.48.0 CPython/3.8.5

File hashes

Hashes for hangul-names-0.4.2.tar.gz
Algorithm Hash digest
SHA256 dfcd3d10d60b991dff369f0048926603eb5f6ec00612961050d5abcc359626a9
MD5 d34b7b8eccffd9309d314202f459ce85
BLAKE2b-256 94c73ddf9dd956c715287d315efe0c5179a380dc2b3ec102e2c234285c5be02d

See more details on using hashes here.

File details

Details for the file hangul_names-0.4.2-py3-none-any.whl.

File metadata

  • Download URL: hangul_names-0.4.2-py3-none-any.whl
  • Upload date:
  • Size: 9.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.2.0 requests-toolbelt/0.9.1 tqdm/4.48.0 CPython/3.8.5

File hashes

Hashes for hangul_names-0.4.2-py3-none-any.whl
Algorithm Hash digest
SHA256 f9588eeb9b52c252fdf9a9a3ca46feb6951d1f5420a6bd0220f488c64f57d060
MD5 22761c9af2cdb2bfd270b5ad68bcaee9
BLAKE2b-256 6b8e0f40356a6e4c5259b39c4b74b54e315d48978bc0a79515ef13f3b12564dd

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page