Google Translate Free

This repository is a robust translation service designed to help you with a variety of language-based features including direct translations, alternate translations, definitions, examples, transliterations, spelling suggestions, language detection, and highly relevant keyword suggestions.

Let's read the documents before using it.

Installation

Add this line to your application's Gemfile:

gem 'google-translate-free', '~> 1.0.1'

And then execute:

$ bundle install

Or install it yourself as:

$ gem install google-translate-free

Usage

To translate

Translate.translate('summer', :vi, :en)
# => "mùa hè"

Without third params, Google Translate will auto-detect your source language.

Translate.translate('summer', :vi)
# => "mùa hè"

For alternate Translations

Translate.alternate_translations('summer', :vi, :en)
# =>
#[
#  "mùa hè",
#  "mùa hạ",
#  "hè"
#]

Without third params, Google Translate will auto-detect your source language.

Translate.alternate_translations('summer', :vi)
# =>
#[
#  "mùa hè",
#  "mùa hạ",
#  "hè"
#]

For definitions

Translate.definitions('summer')
# =>
#[
#  {
#    :noun=>[
#      ["The warmest season of the year, in the northern hemisphere from june to august and in the southern hemisphere from december to february.", "<b>summer</b> vacation.", nil],
#      ["A horizontal bearing beam, especially one supporting joists or rafters.", nil, nil]
#    ]
#  },
#  {
#    :verb=>[
#      ["Spend the summer in a particular place.", nil, nil]
#    ]
#  }
#]

For examples

Translate.examples('summer')
# =>
#[
#  "The plant flowers in late <b>summer</b>.",
#  "The golden <b>summer</b> of her life.",
#  "A long hot <b>summer</b>.",
#  "<b>summer</b> vacation."
#]

For transliteration

Translate.transliteration('summer')
# => "ˈsəmər"

For spelling suggestions

Translate.suggest('summmer')
# => "summer"

For language detection

Translate.detection('summer')
# => ["en", 0.93254006]

For keyword suggestions

Translate.see_more('summers')
# => "summer"

Contributors

datpmt

I welcome contributions to this project.

Fork it.
Create your feature branch (git checkout -b your-feature).
Commit your changes (git commit -am 'Add some feature').
Push to the branch (git push origin your-feature).
Create a new pull request.

License

The gem is available as open source under the terms of the MIT License.

datpmt / google-translate-free Goto Github PK