Skip to content

Latest commit

 

History

History
185 lines (94 loc) · 4.68 KB

README.rdoc

File metadata and controls

185 lines (94 loc) · 4.68 KB

Welcome to Tr8n Translation Engine

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.

Documentation

Please look through the following slides to get familiar with Tr8n concepts and features:

wiki.tr8n.org/slides

Once you are done, you can try out Tr8n features yourself by following the deployement instructions from one of the examples:

github.com/tr8n

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

Installation Instructions

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:

http://localhost:3000/tr8n

Integration Instructions

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://github.com/berk/tr8n.git
$ cd tr8n/sample/tr8n_server
$ rake db:migrate
$ rake tr8n:init
$ rails s

Open your browser and point to:

http://localhost:3000

Tr8n Screenshots

Below are a few screenshots of what Tr8n looks like:

Tr8n Language Selector (in a lightbox)

Tr8n Translation Interface

Tr8n Translation Votes Interface

Tr8n Language Selector (as a dropdown)

Tr8n Translation Interface (with a keyboard)

Tr8n Translation Tools

Tr8n Translator Dashboard

Tr8n Translation Admin Tools

External Links

Yammer in Translation

bit.ly/g5GQDt

Yammer Now Available in Dutch, French, German, Japanese, Korean, and Spanish

bit.ly/heNIPr

Geni Goes Global With 20 New Languages And A Crowdsourced Translation Tool

tcrn.ch/f1VLnj

Quora Discussion - What is the best way to deal with internationlization of text on a large social site?

bit.ly/hUU6R9

LinkedIn Discussion

www.linkedin.com/groups/Internationalizing-your-application-using-Tr8n-4090552?gid=4090552

RailsCasts - If you would like to see a RailsCasts episode on how to get Tr8n configured and running, please visit the RailsCasts suggestion page and vote it up. Thank you!

bit.ly/gz7lFw

Tr8n Discussion on Hacker News

bit.ly/hB2qmU

IRC Channel for Discussing Tr8n

irc.freenode.net/#tr8n