icrowley / webtranslateit

A CLI to sync locale files with webtranslateit.com.

WebTranslateIt Synchronization Tool

RubyDoc | Example app | Report a bug | Support | WebTranslateIt.com Homepage

web_translate_it is a tool to sync your language files with WebTranslateIt.com, a web-based tool to translation software.

This rubygem provides:

1. A Command-Line Interface, wti, to sync files between your computer/server and WebTranslateIt.com. It is cross-platform and runs in a terminal (Linux, MacOS X) or in cmd.exe (Windows).
2. A synchronisation server which provides a web interface for your translation team to update your language files. Learn more on the web_translate_it_server project page.
3. A rack middleware you can use in your Rails app to automatically fetch new translations from WebTranslateIt.

An external library, web_translate_it_server, extends this rubygem and provides a web interface for your translation team to update your language files.

---

Installation

You will also need ruby to run wti. On Linux or a Mac, it’s already installed. Install RubyInstaller if you’re using Windows. See detailed installation instructions for Windows users.

$ gem install web_translate_it
Fetching: web_translate_it-2.0.3.gem (100%)
Successfully installed web_translate_it-2.0.3
1 gem installed

At this point you should have the wti executable working:

$ wti -v
wti version 2.0.3

Configuration

Now that the tool is installed, you’ll have to configure your project. Basically, wti is to be run on a project root directory, and looks for a .wti file containing your project information. The command wti init lets your create your .wti file.

$ wti init
# Initializing project
 Project API Key:  55555abc1235555
 Path to configuration file: (Default: .wti)  

 Your project was successfully initialized.
You can now use `wti` to push and pull your language files.
Check `wti --help` for help.

The command asks you to enter your project API key (you can find it in your project settings) and where to save the configuration file (by default it will create a .wti in your project root directory).

Now you’re all set and you can use the wti commands on your project.

Usage

Execute wti --help to see the usage:

Usage: wti <command> [options]+

The most commonly used wti commands are:

  pull        Pull target language file(s)
  push        Push master language file(s)
  match       Display matching of local files with File Manager
  add         Create and push a new master language file
  addlocale   Add a new locale to the project
  server      Start a synchronisation server
  status      Fetch and display project statistics
  init        Configure your project to sync      

See `wti <command> --help` for more information on a specific command.

[options] are:
  --config, -c <s>:   Path to a translation.yml file (default: .wti)
     --version, -v:   Print version and exit
        --help, -h:   Show this message

Append --help for each command for more information. For instance:

$ wti push --help
Push master language file(s)
[options] are:
      --locale, -l <s>:   ISO code of locale(s) to push
             --all, -a:   Upload all files
    --low-priority, -o:   WTI will process this file with a low priority
           --merge, -m:   Force WTI to merge this file
  --ignore-missing, -i:   Force WTI to not obsolete missing strings
       --label, -b <s>:   Apply a label to the changes
            --help, -h:   Show this message

Sample Commands

Command	Action
wti add path/to/master/file.po	Upload a new master language file
wti add file1.po file2.po file3.xml	Create several master language files at once, by specifying each file
wti add *.po	Create several master language files at once, by specifying an extension
wti push	Update a master language file
wti push -l fr	Update a target (French) language file
wti push -l "fr en da sv"	Update several target language files at once (French, English, Danish, Swedish)
wti push --all	Update all language files at once
wti pull	Download target language files
wti pull -l fr	Download a specific language file (French)
wti pull --all	Download all language files, including source
wti pull --force	Force pull (to bypass WebTranslateIt’s HTTP caching)
wti addlocale fr	Add a new locale to the project
wti addlocale fr da sv	Add several locales at once
wti status	View project statistics
wti match	Show matching between files on local computer and the ones in WebTranslateIt’s File Manager

Hooks

It is sometimes useful to hook a command or a script before or after a push or a pull. One use-case would be to launch a build after pulling language files. You can do that by implementing hooks in your .wti file.

There are 4 hooks:

• before_pull
• after_pull
• before_push
• after_push

Check the sample .wti file for implementation.

License

Copyright (c) 2009-2013 Atelier Convivialité, released under the MIT License.