YaleKorean

Name	YaleKorean JSON
Version	1.0.1 JSON
	download
home_page	https://github.com/SeHaan/YaleKorean
Summary	Korean Yale Romanizer
upload_time	2023-08-14 04:34:30
maintainer
docs_url	None
author	SeHaan
requires_python	>=3.8
license
keywords	yale korean romanizer linguistics pypi
VCS
bugtrack_url
requirements	No requirements were recorded.
Travis-CI	No Travis.
coveralls test coverage	No coveralls.

            # Korean Yale Romanizer (한국어 예일식 로마자 전사 변환기)
Romanizer for Korean following [Yale Romanization](https://en.wikipedia.org/wiki/Yale_romanization_of_Korean). See [Chapter 3](#3-about-korean-yale-romanization) for details.

## 0. History
|date|ver|history|
|:--:|:-:|:-----:|
|20230814|1.0.1|version 1.0.1|
|20230814|0.0.1|test version|
|20230812|-|Initial commit|

## 1. Installation
```cmd
pip install YaleKorean
```

## 2. Main Functions & Usage
From `YaleKorean`, you can use these three functions.

```python
import YaleKorean
```

### 2.2. `YaleKorean.PUAtoUni(line: str) -> str`
```python
test = '안녕하세요'
print(YaleKorean.PUAtoUni(test))
# 안녕하세요
```

### 2.2. `YaleKorean.YaleCont(line: str) -> str`
```python
test_cont = '다람쥐 헌 쳇바퀴 타고파'
print(YaleKorean.YaleCont(test_cont))
# talamcwi hen cheyspakhwi thakopha
```

### 2.3. `YaleKorean.YaleMid(line: str) -> str`
```python
test_mid = '나랏말ᄊᆞ미 듀ᇰ귁에 달아 문ᄍᆞ와로 서로 ᄉᆞᄆᆞᆺ디 아니ᄒᆞᆯᄊᆡ'
print(YaleKorean.YaleMid(test_mid))
# nalasmalssomi tywungkwikey tala mwunccowalwo selwo somosti aniholssoy
```

## 3. About Korean Yale Romanization
### 3.1. Basic Rule
#### 1) Consonants
|Hangul|Romanized|
|:----:|:-------:|
|ㄱ|k|
|ㄲ|kk|
|ㄴ|n|
|ㄷ|t|
|ㄸ|tt|
|ㄹ|l|
|ㅁ|m|
|ㅂ|p|
|ㅃ|pp|
|ㅅ|s|
|ㅆ|ss|
|ㅇ|ng*|
|ㅈ|c|
|ㅉ|cc|
|ㅊ|ch|
|ㅋ|kh|
|ㅌ|th|
|ㅍ|ph|
|ㅎ|h|

*only for 'ㅇ' in coda position. 'ㅇ' in onset position does not have any sound.

#### 2) Vowels
|Hangul|Romanized|
|:----:|:-------:|
|ㅏ|a|
|ㅓ|e|
|ㅗ|o|
|ㅜ|wu*|
|ㅡ|u|
|ㅣ|i|
|ㅐ|ay|
|ㅔ|ey|
|ㅚ|oy|
|ㅟ|wi|
|ㅑ|ya|
|ㅕ|ye|
|ㅛ|yo|
|ㅠ|yu|
|ㅒ|yay|
|ㅖ|yey|
|ㅘ|wa|
|ㅙ|way|
|ㅝ|we|
|ㅞ|wey|
|ㅢ|uy|

*If 'ㅜ' is posited after bilabial sounds /ㅂ, ㅃ, ㅍ/, 'ㅜ' is romanized as 'u.', It is because that 'ㅜ' and 'ㅡ' is neutralized after bilabial sounds.

### 3.2. Notation for Middle Korean
#### 1) Consonants
|Hangul|Romanized|
|:----:|:-------:|
|ㅸ|W|
|ㅹ|WW*|
|ᄛ|L*|
|ㅱ|M*|
|ㆄ|F*|
|ㅿ|z|
|ㅇ|G**|
|ㆁ|ng|
|ㆆ|q|
|ᄼ|S*|
|ᄽ|SS*|
|ᄾ|Sr*|
|ᄿ|SSr*|
|ᅎ|C*|
|ᅏ|CC*|
|ᅐ|Cr*|
|ᅑ|CCr*|
|ᅔ|Ch*|
|ᅕ|Chr*|

*These notations are not in the standard Yale Romanization.<br>
**This notation of 'ㅇ' is only for 'ㅇ'[ɦ].

#### 2) Vowels
- ㆍ(아래아 alay.a) is notated as 'o'.
  - ```YaleCont(str)```: 'O' (capital 'o')
  - ```YaleMid(str)```: 'o'
- 'ㅜ' does not undergo after bilabial sounds.
  - ```YaleCont(str)```: 'wu', 'u'(after bilabials)
  - ```YaleMid(str)```: 'wu' for all contexts

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/SeHaan/YaleKorean",
    "name": "YaleKorean",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": "",
    "keywords": "Yale,Korean,Romanizer,linguistics,pypi",
    "author": "SeHaan",
    "author_email": "alsgk1123@gmail.com",
    "download_url": "https://files.pythonhosted.org/packages/9f/d3/98b369b1957bfc65ab6de4a386442e9cf2ea7260c9318151fc1f73f4004b/YaleKorean-1.0.1.tar.gz",
    "platform": null,
    "description": "# Korean Yale Romanizer (\ud55c\uad6d\uc5b4 \uc608\uc77c\uc2dd \ub85c\ub9c8\uc790 \uc804\uc0ac \ubcc0\ud658\uae30)\r\nRomanizer for Korean following [Yale Romanization](https://en.wikipedia.org/wiki/Yale_romanization_of_Korean). See [Chapter 3](#3-about-korean-yale-romanization) for details.\r\n\r\n## 0. History\r\n|date|ver|history|\r\n|:--:|:-:|:-----:|\r\n|20230814|1.0.1|version 1.0.1|\r\n|20230814|0.0.1|test version|\r\n|20230812|-|Initial commit|\r\n\r\n## 1. Installation\r\n```cmd\r\npip install YaleKorean\r\n```\r\n\r\n## 2. Main Functions & Usage\r\nFrom `YaleKorean`, you can use these three functions.\r\n\r\n```python\r\nimport YaleKorean\r\n```\r\n\r\n### 2.2. `YaleKorean.PUAtoUni(line: str) -> str`\r\n```python\r\ntest = '\uc548\ub155\ud558\uc138\uc694'\r\nprint(YaleKorean.PUAtoUni(test))\r\n# \u110b\u1161\u11ab\u1102\u1167\u11bc\u1112\u1161\u1109\u1166\u110b\u116d\r\n```\r\n\r\n### 2.2. `YaleKorean.YaleCont(line: str) -> str`\r\n```python\r\ntest_cont = '\ub2e4\ub78c\uc950 \ud5cc \uccc7\ubc14\ud034 \ud0c0\uace0\ud30c'\r\nprint(YaleKorean.YaleCont(test_cont))\r\n# talamcwi hen cheyspakhwi thakopha\r\n```\r\n\r\n### 2.3. `YaleKorean.YaleMid(line: str) -> str`\r\n```python\r\ntest_mid = '\ub098\ub78f\ub9d0\u110a\u119e\ubbf8 \u1103\u1172\u11f0\uadc1\uc5d0 \ub2ec\uc544 \ubb38\u110d\u119e\uc640\ub85c \uc11c\ub85c \u1109\u119e\u1106\u119e\u11ba\ub514 \uc544\ub2c8\u1112\u119e\u11af\u110a\u11a1'\r\nprint(YaleKorean.YaleMid(test_mid))\r\n# nalasmalssomi tywungkwikey tala mwunccowalwo selwo somosti aniholssoy\r\n```\r\n\r\n## 3. About Korean Yale Romanization\r\n### 3.1. Basic Rule\r\n#### 1) Consonants\r\n|Hangul|Romanized|\r\n|:----:|:-------:|\r\n|\u3131|k|\r\n|\u3132|kk|\r\n|\u3134|n|\r\n|\u3137|t|\r\n|\u3138|tt|\r\n|\u3139|l|\r\n|\u3141|m|\r\n|\u3142|p|\r\n|\u3143|pp|\r\n|\u3145|s|\r\n|\u3146|ss|\r\n|\u3147|ng*|\r\n|\u3148|c|\r\n|\u3149|cc|\r\n|\u314a|ch|\r\n|\u314b|kh|\r\n|\u314c|th|\r\n|\u314d|ph|\r\n|\u314e|h|\r\n\r\n*only for '\u3147' in coda position. '\u3147' in onset position does not have any sound.\r\n\r\n#### 2) Vowels\r\n|Hangul|Romanized|\r\n|:----:|:-------:|\r\n|\u314f|a|\r\n|\u3153|e|\r\n|\u3157|o|\r\n|\u315c|wu*|\r\n|\u3161|u|\r\n|\u3163|i|\r\n|\u3150|ay|\r\n|\u3154|ey|\r\n|\u315a|oy|\r\n|\u315f|wi|\r\n|\u3151|ya|\r\n|\u3155|ye|\r\n|\u315b|yo|\r\n|\u3160|yu|\r\n|\u3152|yay|\r\n|\u3156|yey|\r\n|\u3158|wa|\r\n|\u3159|way|\r\n|\u315d|we|\r\n|\u315e|wey|\r\n|\u3162|uy|\r\n\r\n*If '\u315c' is posited after bilabial sounds /\u3142, \u3143, \u314d/, '\u315c' is romanized as 'u.', It is because that '\u315c' and '\u3161' is neutralized after bilabial sounds.\r\n\r\n### 3.2. Notation for Middle Korean\r\n#### 1) Consonants\r\n|Hangul|Romanized|\r\n|:----:|:-------:|\r\n|\u3178|W|\r\n|\u3179|WW*|\r\n|\u111b|L*|\r\n|\u3171|M*|\r\n|\u3184|F*|\r\n|\u317f|z|\r\n|\u3147|G**|\r\n|\u3181|ng|\r\n|\u3186|q|\r\n|\u113c|S*|\r\n|\u113d|SS*|\r\n|\u113e|Sr*|\r\n|\u113f|SSr*|\r\n|\u114e|C*|\r\n|\u114f|CC*|\r\n|\u1150|Cr*|\r\n|\u1151|CCr*|\r\n|\u1154|Ch*|\r\n|\u1155|Chr*|\r\n\r\n*These notations are not in the standard Yale Romanization.<br>\r\n**This notation of '\u3147' is only for '\u3147'[\u0266].\r\n\r\n#### 2) Vowels\r\n- \u318d(\uc544\ub798\uc544 alay.a) is notated as 'o'.\r\n  - ```YaleCont(str)```: 'O' (capital 'o')\r\n  - ```YaleMid(str)```: 'o'\r\n- '\u315c' does not undergo after bilabial sounds.\r\n  - ```YaleCont(str)```: 'wu', 'u'(after bilabials)\r\n  - ```YaleMid(str)```: 'wu' for all contexts\r\n",
    "bugtrack_url": null,
    "license": "",
    "summary": "Korean Yale Romanizer",
    "version": "1.0.1",
    "project_urls": {
        "Homepage": "https://github.com/SeHaan/YaleKorean"
    },
    "split_keywords": [
        "yale",
        "korean",
        "romanizer",
        "linguistics",
        "pypi"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "217a795bec541887af56ad6ad02fa185866514d4df1bb64dc18b5f082c22c905",
                "md5": "fa9f313f92dc5b2b8cb3132ba41feba2",
                "sha256": "4a07e8248ce480c87c308e1fbef436e1d86ac23f5c036c7a1c4af05570e53653"
            },
            "downloads": -1,
            "filename": "YaleKorean-1.0.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "fa9f313f92dc5b2b8cb3132ba41feba2",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 34914,
            "upload_time": "2023-08-14T04:34:28",
            "upload_time_iso_8601": "2023-08-14T04:34:28.598285Z",
            "url": "https://files.pythonhosted.org/packages/21/7a/795bec541887af56ad6ad02fa185866514d4df1bb64dc18b5f082c22c905/YaleKorean-1.0.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "9fd398b369b1957bfc65ab6de4a386442e9cf2ea7260c9318151fc1f73f4004b",
                "md5": "53fc55f649dea8cd3ae8772df072f83f",
                "sha256": "add0d6a7c1c26763aa08a1052a007b681f5d2b463d023012b81972f5ae23f36b"
            },
            "downloads": -1,
            "filename": "YaleKorean-1.0.1.tar.gz",
            "has_sig": false,
            "md5_digest": "53fc55f649dea8cd3ae8772df072f83f",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 37588,
            "upload_time": "2023-08-14T04:34:30",
            "upload_time_iso_8601": "2023-08-14T04:34:30.406399Z",
            "url": "https://files.pythonhosted.org/packages/9f/d3/98b369b1957bfc65ab6de4a386442e9cf2ea7260c9318151fc1f73f4004b/YaleKorean-1.0.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-08-14 04:34:30",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "SeHaan",
    "github_project": "YaleKorean",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "yalekorean"
}