Globalize Automatic

Installation

gem install globalize-automatic

Rails 5.0

In your Gemfile

gem 'globalize-automatic', github: 'takeyuweb/globalize-automatic', branch: 'rails-5-0'

and

bundle install

Configuration

# config/initializers/globalize_automatic.rb
require 'globalize-automatic'
Globalize::Automatic.translator = 
  Globalize::Automatic::Translator::EasyTranslate.new

# EasyTranslate configuration
EasyTranslate.api_key = 'xxx'

Example

宣言

class Post
  # Automatically translated from English.
  translates :title, :text, automatic: :en
end

class Post
  # Automatically translated from English or Japanese. (English preferred)
  translates :title, :text, automatic: %i(en ja)
end

class Post
  # Automatically translated from English
  translates :title, :text, automatic: { from: :en, to: %i(ja fr vi) }
end

class CreatePostAutomatics < ActiveRecord::Migration
  def up
    Post.create_translation_table! title: :string, text: :text
    Post.create_automatic_translation_table! :title, :text
  end
    
  def down
    Post.drop_translation_table!
    Post.drop_automatic_translation_table!
  end
end

自動翻訳対象を追加

class AddPostAutomatics < ActiveRecord::Migration
  def up
    Post.add_translation_fields! description: :text
    Post.add_automatic_translation_fields! :description
  end
    
  def down
    remove_column :post_automatic_translations, :description
    remove_column :post_automatic_translations, :description_automatically
  end
end

更新

自動翻訳

I18n.locale = :en
post.title = 'globalize'
post.save!

post.title_ja_automatic # => false
post.title_vi_automatic # => true

post.reload

I18n.locale = :ja
post.title # => nil
I18n.locale = :vi
post.title # => 'โลกาภิวัฒน์'

post.attributes = {
   title_en: 'globalize',
   title_ja_automatic: true
}
post.save!

post.reload

I18n.locale = :en
post.title # => 'globalize'
I18n.locale = :ja
post.title # => '国際化'

自動翻訳無効化

post.attributes = {
   title_en: 'globalize',
   title_fr_automatic: false,
   title_fr: 'Hoge'
}
post.save!

post.reload

I18n.locale = :en
post.title # => 'globalize'
I18n.locale = :vi
post.title # => 'โลกาภิวัฒน์'
I18n.locale = :fr
post.title # => 'hoge'

自動翻訳の原文優先順位

class Post
  # Automatically translated from English or Japanese. (English preferred)
  translates :title, :text, automatic: %i(en ja)
end

post = Post.new
post.attributes = {
    title_en: 'English',
    title_ja: '日本語'
}
post.save!

post.reload

I18n.locale = :fr
post.title # => 'Anglais' # It means 'English'.

class Post
  # Automatically translated from English or Japanese. (English preferred)
  translates :title, :text, automatic: %i(en ja)
end

post = Post.new
post.attributes = {
    title_en: nil,
    title_ja: '日本語'
}
post.save!

post.reload

I18n.locale = :fr
post.title # => 'Japonais' # It means '日本語'.

取得

翻訳文属性名

globalize-accessors

Post.globalize_attribute_names # => [:title_ja, :title_en, :title_fr, :title_vi, :text_ja, :text_en, :text_fr, :text_vi]

自動翻訳有効/無効属性名

Post.automatic_translation_attribute_names # => [:title_ja_automatically, :title_en_automatically, :title_fr_automatically, :title_vi_automatically, :text_ja_automatically, :text_en_automatically, :text_fr_automatically, :text_vi_automatically]

strong parameters

permitted = Post.globalize_attribute_names + Post.automatic_translation_attribute_names
params.require(:post).permit(*permitted)

非同期

ActiveJobを利用による非同期翻訳

# config/initializers/globalize_automatic.rb
Globalize::Automatic.asynchronously = true

他の翻訳ライブラリやサービスへの対応

Translatorクラスを書けば対応できます。

class YourTranslator < Globalize::Automatic::Translator
  def translate(text, from, to)
    # 適当な翻訳処理を行って訳文を返す
    return translated
  end
end

Globalize::Automatic.translator = YourTranslator::EasyTranslate.new

TODO

• EasyTranslate依存の切り出し
  • 他の翻訳ライブラリやサービスへの対応。
    • Microsoft Translator
    • Gengo etc

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/takeyuweb/globalize_automatic. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

Licence

Copyright (c) 2017 Yuichi Takeuchi released under the MIT license

This project rocks and uses MIT-LICENSE.