Tml for Ruby on Rails

translationexchange.com
Powered by Translation Exchange
Translation Markup Language
for Ruby on Rails

Michael Berkovich
michael@translationexchange.com
@translationx

Localization is cumbersome

There are many
standards, but little
guidance.
“

Every i18n framework has its own “right way”
of doing things, with a different syntax and file
format.
Developers often hack together their own
solutions to try and simplify the process.
No universality
in the current
standards

Android .xml
Apple .strings
Apple .plist
Gettext .po
Gettext .pot
Java .properties
Java .xml
Microsoft .resx
Microsoft .resw
Microsoft .resjson
Microsoft .aspx
FILE FORMATS
Lots of translation
Microsoft .rc
PHP .ini
PHP .conf
Babel Flash .xml
Blackberry .rrc
NSIS .insh
QT Linguist .ts
Latex .latex
Docbook .dbk
TBX .tbx
TMX .tmx
XLIFF .xliff
YouTube .sbv
Rails YAML .yaml
Subtitles .srt
MicroDVD .sub
Subviewer .sub
Mozilla Web L10N
Text .txt
CSV Spreadsheet
Excel Spreadsheet
Word Document

Extract content into
files
Upload files to a TMS
or an LSP
Wait... Download translated
files
Put translations back
in your app
Repeat when new content is added or changed
BOTTLENECK
File management is a

File Management
● Not DRY (Don’t Repeat Yourself)
● Requires content extraction, sync with a TMS or an LSP
● Mini “waterfalls” in the agile process
● Slows down development cycle and releases
● High upfront cost and maintenance

How can we make it
BETTER FOR
EVERYONE

What would an ideal solution
look like?
● Consistency
Provide tools that offer a clear and
consistent way for internationalizing
content across all frameworks
● Adaptability
Tools must be extensible and adaptable
and should be able to solve any arising
internationalization and localization
problem
● Contextualization
Allow translators to translate in context
from within the application
● Agility
Keep the development cycle agile -
localization must not add significant
overhead for developers - it must be done
in parallel to the development process

あ
A
Translation Management
Service
Global CDN
Local Cache
Application
with SDK
A Better Way
A truly automated and continuous localization

Translation Caching
static and dynamic cache adapters for
storing translations in your application
Inline Translation Tools
Translation can be done in context of the
application
Access Professional Translators
Connect your application to thousands of
professional translators around the world
Open Source
all SDKs are available on github
Multiple Platforms
support for Rails, Node, PHP, Python, iOS,
Android and more
Universal Translation Memory
Translations are shared across all
applications
Core Benefits

Getting Started

gem 'tml-rails'
Integration
# Gemfile

Configuration
# initializers/tml.rb
Tml.configure do |config|
config.application = {
key: “YOUR_APPLICATION_KEY”
}
end
# layouts/application.html.erb
<%= tml_scripts_tag %>
<%= tml_language_selector_tag(:flags) %>

Developer friendly syntax for marking up application content.
Supports language context rules and language cases, making translations
significantly more accurate for any language.

Hello World
<%= tr('Hello World') %>

tr('Eats shoots and leaves', 'a panda')
Eats shoots and leaves
tr('Eats shoots and leaves', 'a violent restaurant patron')
Description & Context

Hello Michael
Data Tokens & Interpolation
<%= tr('Hello {name}', {name:'Michael'}) %>

Hello Michael
<%= tr('Hello [bold: {user}]', {
user: current_user
}) %>
Decoration Tokens

Hello Michael
<%= tr('Hello <strong>{user}</strong>', {
user: current_user
}) %>
Decoration Tokens

Hello Michael
<%= tr('Hello [bold: {user}]', {
user: current_user,
bold: '<strong>{$0}</strong>'
}) %>
Decoration Tokens

You have 5 messages
<%= tr(You have {count || message}', {
count: 5
}) %>
Pluralization

Michael uploaded 3 photos
<%= tr('{user} uploaded {count || photo}', {
user: current_user,
count: 3
}) %>
Pluralization

Michael liked Anna’s post
<%= tr('{actor} liked {target::pos} post', {
actor: current_user,
target: other_user
}) %>
Language Cases

This is your second warning
<%= tr(This is your {count::ord} warning', {
count: 2
}) %>
Language Cases

Michael completed 3 miles on his last run.
<%= tr('[link: {user}] completed [bold: {count || mile}]
on {user | his, her} last run.', {
user: current_user,
link: { href: user_path },
count: 3
}) %>

Demo
❏ Use TML SDK to localize an online recipes application
❏ Demonstrate crowdsourced localization tools
❏ Deploy translation release and update application realtime
❏ Download release snapshot and run Foody independently from the
service

How is Translation Done?
Machine Translation
provided by Google,
Microsoft and Yandex.
Translations are ranked to
get the best result.
Crowdsourced Translation
Some developers may
choose to use their own
users to translate their
content, similar to how
Facebook and Twitter
translated their sites.
Professional Translation
Order are received and
processed by our partners
and are made available in our
system within hours.

Caching Options
Static Cache
File based cache. Loaded into the process
memory and must be deployed with the
source code. Each process contains the
entire translation cache.
$ bundle exec rake tml:cache:generate
Dynamic Cache
Redis, Memcached (and others) updated
from CDN release. Cache is shared
across all processes. Can be deployed
without restarting servers.
$ bundle exec rake tml:cache:upgrade

SDKs https://github.com/translationexchange
Documentation http://translationexchange.com/docs
Blog http://blog.translationexchange.com
Foody Source https://github.com/translationexchange/tml-rails-samples-foody
Foody Live http://foody.translationexchange.com
Facebook https://www.facebook.com/translationexchange
Twitter @translationx
Feedback feedback@translationexchange.com
Resources

Thank You
Find out more at translationexchange.com

Tml for Ruby on Rails

More Related Content

What's hot (20)

Viewers also liked (20)

Similar to Tml for Ruby on Rails (20)

Recently uploaded (20)

Tml for Ruby on Rails