Notice: Since berk/tr8n is maintained no longer, this is the attempt to let tr8n survival in her natural habitat. Don’t expect too much documentation.
Tr8n Translation Engine is a Rails Engine Plugin/Gem that provides a framework for crowd-sourced translations of your Rails application. The power of the engine comes from its simple and friendly user interface that allows site users as well as professional translators to rapidly translate the site into hundreds of languages.
The rules engine that powers Tr8n allows translators to indicate whether sentences depend on gender rules, number rules or other rules configured for each language. The language specific context and case rules can be registered and managed for any language in the advanced user interface. The engine provides a set of powerful administration tools that allow admins to configure any aspect of the engine; enabling and disabling its features and monitoring translation progress.
The Tr8n engine is based on a robust and flexible pluggable architecture where rule types and even the syntax of the “tr” tokens can be configured or extended for any application deployment.
Tr8n translation engine has been successfully deployed by the following companies:
Geni Inc, www.geni.com
Yammer Inc, www.yammer.com
You can visit their web sites and see how it is being used. If your company is using Tr8n, please let me know and you will be added to the list.
Once you are done, you can try out Tr8n features yourself by following the deployement instructions from one of the examples:
Configuration Guide
github.com/berk/tr8n/wiki/4.-Configuration-Instructions
Integration Guide
github.com/berk/tr8n/wiki/5.-Integration-Instructions
Translation Markup Language (TML)
github.com/berk/tr8n/wiki/6.-Tr8n-Syntax-and-Translation-Markup-Language
Rules Engine
github.com/berk/tr8n/wiki/7.-Tr8n-Rules-Engine
Language Context Rules
github.com/berk/tr8n/wiki/7.1-Language-Context-Rules
Language Case Rules
github.com/berk/tr8n/wiki/7.2-Language-Case-Rules
Supported Languages
github.com/berk/tr8n/wiki/9.-Supported-Languages
Add the following gems to your Gemfile:
gem 'will_filter', "~> 3.1.2" gem 'tr8n', "~> 3.2.1"
And run:
$ bundle
At the top of your routes.rb file, add the following lines:
mount WillFilter::Engine => "/will_filter" mount Tr8n::Engine => "/tr8n"
To configure and initialize Tr8n engine, run the following commands:
$ rails generate will_filter $ rails generate tr8n $ rake db:migrate $ rake tr8n:init $ rails s
Open your browser and point to:
https://localhost:3000/tr8n
The best way to get going with Tr8n is to run the gem as a stand-alone application and follow the instructions and documentation in the app:
$ git clone git:https://github.com/berk/tr8n.git $ cd tr8n/local/tr8n_server $ rake db:migrate $ rake tr8n:init $ rails s
Open your browser and point to:
https://localhost:3000
Yammer in Translation
Yammer Now Available in Dutch, French, German, Japanese, Korean, and Spanish
Geni Goes Global With 20 New Languages And A Crowdsourced Translation Tool
Quora Discussion - What is the best way to deal with internationlization of text on a large social site?
Tr8n Discussion on Hacker News
IRC Channel for Discussing Tr8n
irc.freenode.net/#tr8n