https://github.com/keepcosmos/ununiga

[은는이가] 한글 조사(助詞) 대응 I18n engine extension
https://github.com/keepcosmos/ununiga

i18n korean plugin rails

Last synced: 3 months 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 (over 9 years ago)
• Default Branch: master
• Last Pushed: 2024-02-29T05:24:40.000Z (9 months ago)
• Last Synced: 2024-04-30T15:41:04.154Z (7 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

Awesome Lists containing this project

• awesome-hangul - ununiga - 한글 자소 분리 및 은/는, 이/가 등의 조사가 포함된 로케일 처리를 위한 라이브러리 (Programming Languages / Ruby)

README

        
[![Build Status](https://travis-ci.org/keepcosmos/ununiga.svg?branch=master)](https://travis-ci.org/keepcosmos/ununiga)

[![Gem Version](https://badge.fury.io/rb/ununiga.svg)](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}` 을 사용합니다.