Settings to transform Sino-Korean words written in hanja into hangul letters.

Transforms hanja words in the given HTML entities into corresponding hangul words.

Reads a hanja character as a hangul character.

>>> phoneticizeHanjaChar '漢'
'한'

Note that it does not follow Initial Sound Law (頭音法則):

>>> phoneticizeHanjaChar '六'
'륙'

Represents a dictionary that has hanja keys and values of their corresponding hangul readings, e.g., [("敗北", "패배")].

A function to phoneticize a Sino-Korean (i.e., hanja) word (漢字語) into hangul letters. See also phoneticizeHanjaWord, phoneticizeHanjaWordWithInitialSoundLaw, and withDictionary.

Reads a hanja word and returns a corresponding hangul word.

>>> :set -XOverloadedStrings
>>> phoneticizeHanjaWord "漢字"
"한자"

Note that it does not apply Initial Sound Law (頭音法則):

>>> phoneticizeHanjaWord  "來日"
"래일"

It is like phoneticizeHanjaWord, but it also applies Initial Sound Law (頭音法則).

>>> :set -XOverloadedStrings
>>> phoneticizeHanjaWordWithInitialSoundLaw  "來日"
"내일"
>>> phoneticizeHanjaWordWithInitialSoundLaw  "未來"
"미래"

Reads a hanja word according to the given dictionary, or falls back to the other phoneticizer if there is no such word in the dictionary.

It's basically replace one with one:

>>> :set -XOverloadedLists -XOverloadedStrings
>>> let phone = withDictionary [("自轉車", "자전거")] phoneticizeHanjaWord
>>> phone "自轉車"
"자전거"

But, if it faces any words or characters that are not registered in the dictionary, it does the best to interpolate prefixes/infixes/suffixes using the fallback phoneticizer:

>>> phone "自轉車道路"
"자전거도로"
>>> phone "二輪自轉車"
"이륜자전거"

A function to render a Sino-Korean (i.e., hanja) word (漢字語). Choose one in hangulOnly, hanjaInParentheses, and hanjaInRuby.

Renders a word in hangul-only, no hanja at all (e.g., 안녕히).

Renders a word in hangul followed by hanja in parentheses (e.g., 안녕(安寧)히).

Renders a word in ruby tag (e.g., <ruby>安寧<rp>(</rp><rt>안녕</rt><rp>)</rp></ruby>히).

Please read Use Cases & Exploratory Approaches for Ruby Markup as well for more information.

Converts a hangul character according to Initial Sound Law (頭音法則).

>>> convertInitialSoundLaw '념'
'염'

If an input is not a hangul syllable or a syllable is not applicable to the law it returns the given input without change:

>>> convertInitialSoundLaw 'A'
'A'
>>> convertInitialSoundLaw '가'
'가'

The Initial Sound Law (頭音法則) table according to South Korean Hangul Orthography (한글 맞춤법) Clause 5, Section 52, Chapter 6 (第6章52項5節). Keys are an original Sino-Korean sound and values are a converted sound according to the law.

Contains the same contents to initialSoundLawTable except that keys and values are crossed: keys are a converted sound and values are possible original sounds.

It's a kind of inverse function of convertInitialSoundLaw, except it returns a set of candidates instead of a single canonical answer because Initial Sound Law (頭音法則) is not a bijective function.

>>> revertInitialSoundLaw '예'
fromList "례"
>>> revertInitialSoundLaw '염'
fromList "념렴"

It returns an empty set if an input is not applicable to the law:

>>> revertInitialSoundLaw '가'
fromList ""