Achtung!¶ ↑

This project is abandoned, and won’t be continued. Next iteration is Translator engine, currently available at: “github.com/amberbit/translator”. Much more translations love there.

GoTranslateYourself¶ ↑

GoTranslateYouself is Rails 3 engine, that allows your clients to do the dirty work of translating applications on their own. You don’t have to do it yourself, let them have a piece of fun of their own!

This project is inspired by DHH’s Tolk (github.com/dhh/told), however it has a bit differen UI, provides way to integrate with existing admin panel layout and is using key-value stores, with translation fallbacks.

It works with both Ruby 1.9 and Ruby 1.8.x (on head)

Installation¶ ↑

TODO: Write more info here.

Usage¶ ↑

Create initializer in your Rails app, following this code:

conn = Mongo::Connection.new.db("go_translate_yourself_test").collection("translations")
GoTranslateYourself.current_store = GoTranslateYourself::MongoStore.new(conn)
GoTranslateYourself.locales = [:pl, :de]

I18n.backend = I18n::Backend::KeyValue.new GoTranslateYourself.current_store

GoTranslateYourself.auth_handler = proc {
  authenticate_or_request_with_http_basic do |user_name, password|
    user_name == 'some' && password == 'user'
  end
}

GoTranslateYourself.layout_name = "dummy_admin"

Please note, that you can integrate auth_handler with your authentication solution (like Devise), or leave it blank for no authentication.

Visit localhost:3000/site_translations to see it working!

Available stores¶ ↑

Currently only MongoDB is supported – please feel free to add more stores (Riak would be nice!).

Roadmap¶ ↑

• implement SQLStore for using SQL databases

• implement RiakStore for using Riak

This project rocks and uses MIT-LICENSE.