Web Translate It
web_translate_it is a rubygem providing tools to sync your language files with Web Translate It, a web-based computer-aided translation tool.
This gem provides 4 tools:
- an executable,
wti, that will help you to upload and download language files from the command line,
- a synchronisation server to help your translation team update your language files from a web-based interface,
- a handful of rake task you can use with your Ruby on Rails application,
- a rack middleware to automatically fetch new translations from Web Translate It.
gem install web_translate_it
At this point you should have the
wti executable working.
If your project if already set up on Web Translate It, open a terminal and type
wti autoconf to generate the configuration file.
wti --help to see the usage:
Usage: wti [-lcphv] pull Pull target language file(s). push Push master language file(s). add Create and push a new master language file. server Start a synchronisation server stats Fetch and display project statistics. autoconf Configure your project to sync. Synchronization options: -l, --locale ISO code of a locale to pull or push. -c, --config Path to a translation.yml file. (default: config/translation.yml). --all Download or upload all files. --force Force wti pull to download files. --merge Force WTI to merge this file. --ignore_missing Force WTI to not obsolete missing strings. Server options: -p, --port Run server on a specific port (default: 4000). -h, --host Run server on a specific host (default: localhost). Other options: --help Show this message -v, --version Show version
Now that the tool is installed, you’ll have to configure your project:
It will ask for your Web Translate It API key, and where to save its configuration file. Letting it put in
config/translations.yml makes everything easier.
Uploading your first language file
If you have no file on Web Translate It yet, you need to send us your master language files. You can do it from the web interface, or from the command line:
wti add path/to/master/file.po
You can also add several files at once:
wti add file1.po file2.po file3.xml
wti add *.po
After receiving your master language files, Web Translate It will automatically create the corresponding, empty target files. If you have already some translations for these files, use
wti push --all to synchronise them to Web Translate It.
Updating a master language file
Updating a target language file
wti push -l fr
fr should be replaced by the locale code of your file.
Updating all language files
wti push --all
Download target language files
Download a specific language file
wti pull -l fr
Download all the language files
wti pull --all
Force pull (bypasses Web Translate It’s HTTP caching)
wti pull --force
View project stats
Web Translate It Synchronisation Console
wti gem integrates since its version 1.7.0 a sinatra back-end that allow you to sync your translations directly from a friendly web interface. It allows a translation team to refresh the language files on a staging server without having to ask the developers to manually
To get started, go to the directory of the application you want to sync and do:
By default, it starts an application on localhost on the port 4000. You will find the tool on
Should you need to use another host or port, you can use the -h and -p options. For example:
wti server -p 1234.
You may want to run some commands before or after synching translations. To do so, add in the
translation.yml file the following:
before_pull: "echo 'some unix command'" after_pull: "touch tmp/restart.txt"
after_pull will respectively be executed before and after pulling your language files.
This gem includes some rake tasks and a rack middleware you could use to integrate Web Translate It with Ruby on Rails. The rake tasks are significantly slower than the executable, since it has to load the whole rails stack.
Add to your config/environments.rb:
If you did not already did
wti autoconf, copy your API key from Web Translate It and run:
script/generate webtranslateit --api-key your_key_here
The generator does two things:
- It adds a auto-configured
config/translation.ymlfile using Web Translate It’s API.
- It adds
require 'web_translate_it/tasks' rescue LoadErrorto your
- It adds a auto-configured
There are 3 rake tasks.
Fetch the latest translations for all your files for all languages defined in Web Translate It’s interface, except for the languages set in
Fetch the latest translations for all the languages defined in Web Translate It’s interface. It takes the locale name as a parameter
Upload to Web Translate It your files in a specific locale defined in Web Translate It’s interface.
Read more about Rails integration in the wiki.
Supported Rails Versions
The gem currently has been tested against the following versions of Rails:
Please open a discussion on our support site if you're using a version of Rails that is not listed above and the gem is not working properly.
- The executable’s commands are very much inspired from Gemcutter,
- The Rails generator was pinched from Hoptoad Notifier,
- The idea of a web-app to sync translations with Web Translate It come from Tom Lea’s awesome rack-webtranslateit,
- The Sinatra app is much inspired from Chris Wanstrath’s CI Joe.
What is Web Translate It anyway?
Web Translate It is a web-based computer-aided translation tool to collaboratively translate software.
To learn more about it, please visit our tour page.
This gem is released under the MIT License.