ununiga's Introduction

ununiga[은는이가]

은는이가는 한글의 자소를 분리하고 적절한 조사를 찾아주는 역할을 합니다.
I18n의 Backend 모듈도 제공합니다.

Installation

gem install ununiga

조사 찾기

require 'ununiga'

Ununiga::JosaPicker.takewell("레일즈와(과) 쟝고은(는) 싸우지 않습니다.")
# => "레일즈와 쟝고는 싸우지 않습니다."
Ununiga::JosaPicker.takewell("페이스북(으)로 로그인합니다.")
# => "페이스북으로 로그인합니다."

picker = Ununiga::JosaPicker.new("레일즈은(는) 루비을(를) 사용합니다.")
picker.takewell
# => "레일즈는 루비를 사용합니다.

picker.josas
# => [[3, ["은", "는"]], [10, ["을", "를"]]]

I18n에 적용하기

Gemfile에 ununiga를 추가합니다.

gem 'ununiga'

Initializer나 environment config파일에 아래 코드를 추가합니다.

I18n::Backend::Simple.send(:include, Ununiga::I18n::JosaTransformer)

한글 locale yml 파일에 조사를 사용하는 부분을 찾아 '은(는)|(는)은|을(를)...'등으로 조사를 변경합니다.

links:
  sign_in_with_provider: "%{provider}(으)로 로그인"

# Rails의 ActiveModel/ActiveRecord의 Validation을 사용할 경우
errors:
  # 디폴트는 `%{attribute} %{message}`형식으로 띄워쓰기가 되어 있으므로 format을 붙여쓰기로 변경해줍니다.
  foramt: "%{attribute}%{message}"
  messages:
    accepted: 을(를) 반드시 확인해야 합니다.
    equal_to: 은(는) %{count}와(과) 같아야 합니다

자소 분리하기

splitter = Ununiga::JasoSplitter.new('흯')
splitter.chosung       # => 'ㅎ'
splitter.jungsung      # => 'ㅢ'
splitter.jongsung      # => 'ㄳ'
splitter.split         # => ['ㅎ', 'ㅢ', 'ㄳ']