Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/keepcosmos/ununiga
[은는이가] 한글 조사(助詞) 대응 I18n engine extension
https://github.com/keepcosmos/ununiga
i18n korean plugin rails
Last synced: about 1 month ago
JSON representation
[은는이가] 한글 조사(助詞) 대응 I18n engine extension
- Host: GitHub
- URL: https://github.com/keepcosmos/ununiga
- Owner: keepcosmos
- License: mit
- Created: 2015-05-05T08:41:51.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2024-02-29T05:24:40.000Z (4 months ago)
- Last Synced: 2024-04-30T15:41:04.154Z (2 months ago)
- Topics: i18n, korean, plugin, rails
- Language: Ruby
- Homepage:
- Size: 28.3 KB
- Stars: 40
- Watchers: 6
- Forks: 8
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Lists
- awesome-hangul - ununiga - 한글 자소 분리 및 은/는, 이/가 등의 조사가 포함된 로케일 처리를 위한 라이브러리 (Programming Languages / Ruby)
README
[](https://travis-ci.org/keepcosmos/ununiga)
[](https://badge.fury.io/rb/ununiga)
# ununiga[은는이가]
은는이가는 한글의 자소를 분리하고 적절한 조사를 찾아주는 역할을 합니다.
I18n의 Backend 모듈도 제공합니다.
## Installation
```
gem install ununiga
```
### 조사 찾기
```ruby
require 'ununiga'
Ununiga::JosaPicker.takewell("레일즈와(과) 쟝고은(는) 싸우지 않습니다.")
# => "레일즈와 쟝고는 싸우지 않습니다."
Ununiga::JosaPicker.takewell("페이스북(으)로 로그인합니다.")
# => "페이스북으로 로그인합니다."
picker = Ununiga::JosaPicker.new("레일즈은(는) 루비을(를) 사용합니다.")
picker.takewell
# => "레일즈는 루비를 사용합니다.
picker.josas
# => [[3, ["은", "는"]], [10, ["을", "를"]]]
```
### I18n에 적용하기
1. Gemfile에 ununiga를 추가합니다.
```
gem 'ununiga'
```
2. Initializer나 environment config파일에 아래 코드를 추가합니다.
```ruby
I18n::Backend::Simple.send(:include, Ununiga::I18n::JosaTransformer)
```
3. 한글 locale yml 파일에 조사를 사용하는 부분을 찾아 '은(는)|(는)은|을(를)...'등으로 조사를 변경합니다.
```yaml
links:
sign_in_with_provider: "%{provider}(으)로 로그인"
# Rails의 ActiveModel/ActiveRecord의 Validation을 사용할 경우
errors:
# 디폴트는 `%{attribute} %{message}`형식으로 띄워쓰기가 되어 있으므로 format을 붙여쓰기로 변경해줍니다.
foramt: "%{attribute}%{message}"
messages:
accepted: 을(를) 반드시 확인해야 합니다.
equal_to: 은(는) %{count}와(과) 같아야 합니다
```
### 자소 분리하기
```ruby
splitter = Ununiga::JasoSplitter.new('흯')
splitter.chosung # => 'ㅎ'
splitter.jungsung # => 'ㅢ'
splitter.jongsung # => 'ㄳ'
splitter.split # => ['ㅎ', 'ㅢ', 'ㄳ']
```
## Test
두가지 방식으로 테스트 할 수 있습니다.
* `rake test` 혹은 그냥 `rake` 커맨드를 사용합니다.
* 특정 파일을 테스트할 경우 `ruby -Ilib:test /test/{file_name}` 을 사용합니다.