gtranslate-two

This is a simple Ruby gem designed to use Google Translate API v2 - unlike other gems which use the first version of the API. Also unlike other available gems, this one requires the use of an API key, which you can get from the Google APIs console (code.google.com/apis/console/).

Basic use:

# First, require the gem: require ‘gtranslate-two’

# Second, set your API key GTranslator.key = ‘YOUR_GOOGLE_TRANSLATE_KEY’

# Now, let’s try translating something from English to Icelandic GTranslator.translate(‘Hello world’, GLanguage::Icelandic, GLanguage::English) # The result (in irb console) should look something like this: #<GTranslatorResult:0x1013e8558 @original=“Hello world”, @source=“en”, @translation=“Hall303263 heimur”, @target=“is”> # As you can see, the result is a GTranslatorResult object with properties: # - original (the original query) # - source (source language) # - translation (translated query) # - target (target language)

# The gem also supports Google Translate language detection mechanism. Let’s imagine we did not know the source language but still wanted to translate the phrase to, say, Irish. # To do that, we’ll basically leave out the third argument in the translate method, falling back on automatic language detection: GTranslator.translate(‘Hello world’, GLanguage::Irish) # The result (in irb console) should look somewhat like this: #<GTranslatorResult:0x1013dced8 @original=“Hello world”, @source=“en”, @translation=“Dia duit ar domhan”, @target=“ga”> # As you can see, the result is a GTranslatorResult object with the same set of properties, only this time the source is determined automatically.

# Last but not least the gem supports language detection operation (without translation) GTranslator.detect_language(‘Mam na imie Marcin’) # The result should be “pl”

# The gem supports all languages supported by Google Translate API. They are implemented in the GLanguage module as constants:

GLanguage::Afrikaans = ‘af’ GLanguage::Albanian = ‘sq’ GLanguage::Arabic = ‘ar’ GLanguage::Belarusian = ‘be’ GLanguage::Bulgarian = ‘bg’ GLanguage::Catalan = ‘ca’ GLanguage::Chinese_Simplified = ‘zh-CN’ GLanguage::Chinese_Traditional = ‘zh-TW’ GLanguage::Croatian = ‘hr’ GLanguage::Czech = ‘cs’ GLanguage::Danish = ‘da’ GLanguage::Dutch = ‘nl’ GLanguage::English = ‘en’ GLanguage::Estonian = ‘et’ GLanguage::Filipino = ‘tl’ GLanguage::Finnish = ‘fi’ GLanguage::French = ‘fr’ GLanguage::Galician = ‘gl’ GLanguage::German = ‘de’ GLanguage::Greek = ‘el’ GLanguage::Haitian_Creole = ‘ht’ GLanguage::Hebrew = ‘iw’ GLanguage::Hindi = ‘hi’ GLanguage::Hungarian = ‘hu’ GLanguage::Icelandic = ‘is’ GLanguage::Indonesian = ‘id’ GLanguage::Irish = ‘ga’ GLanguage::Italian = ‘it’ GLanguage::Japanese = ‘ja’ GLanguage::Latvian = ‘lv’ GLanguage::Lithuanian = ‘lt’ GLanguage::Macedonian = ‘mk’ GLanguage::Malay = ‘ms’ GLanguage::Maltese = ‘mt’ GLanguage::Norwegian = ‘no’ GLanguage::Persian = ‘fa’ GLanguage::Polish = ‘pl’ GLanguage::Portuguese = ‘pt’ GLanguage::Romanian = ‘ro’ GLanguage::Russian = ‘ru’ GLanguage::Serbian = ‘sr’ GLanguage::Slovak = ‘sk’ GLanguage::Slovenian = ‘sl’ GLanguage::Spanish = ‘es’ GLanguage::Swahili = ‘sw’ GLanguage::Swedish = ‘sv’ GLanguage::Thai = ‘th’ GLanguage::Turkish = ‘tr’ GLanguage::Ukrainian = ‘uk’ GLanguage::Vietnamese = ‘vi’ GLanguage::Welsh = ‘cy’ GLanguage::Yiddish = ‘yi’

Contributing to gtranslate-two

Check out the latest master to make sure the feature hasn’t been implemented or the bug hasn’t been fixed yet
Check out the issue tracker to make sure someone already hasn’t requested it and/or contributed it
Fork the project
Start a feature/bugfix branch
Commit and push until you are happy with your contribution
Make sure to add tests for it. This is important so I don’t break it in a future version unintentionally.
Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.

gtranslate-two

Contributing to gtranslate-two

Copyright