After installation and configuration of the Ruby Gem Locale project on the rails, Locale allows to synchronize the project's translations in Localeapp.com, and the files from config/locales/ in your local project ... and vice versa!
It's very important to notice that trust source is translation stored on Localeapp.com
There are two main ways to manage synchronizations:
- from terminal, using command lines of the gem localeapp
- by refreshing browser where localhost's project is displayed (specific to Ruby on Rails projects)
Using terminal, 5 commands are very useful to update your translations: add,rm, push, pull and update.
They each have different consequences on the localeapp.com project or locally, summarized in the diagram below by gray arrows.
-
localeapp addcreate a translation (key and value) and sends it directly to localeapp.com, but it don't modify the local project. -
localeapp rmremoves the translation's key (and associated content) on localeapp.com, but does not remove it from the local project either. -
localeapp pushpushes a translation file or directory from local project to localeapp.com
- It creates key if it doesn't exist on localeapp.com, and import corresponding value,
- It update value of existing key on localeapp.com if it has been updated on local project,
- It doesn't delete keys and corresponding values on localeapp.com if they have been deleted on your project (localeapp.com is the trust source)
localeapp pullpulls all translations from localeapp.com.
- It imports exactly every key and every value from localeapp.com, and create new yml files fro every locale. Consequently, every change stored only in the RoR project will be overwritten (localeapp.com is the trust source)
localeapp update
- It scans on localeapp.com if there are any changes to the translations (keys and values), and if so, imports only these keys and values.
- Consequently, if value has been updated only on local project, this scan won't detect any change on localeapp.com, and not any value modification will be imported on your project.
- Best way to save RoR modifications is to proceed first to
localeapp push(indeed, localeapp.com is the trust source)
Localeapp allows two specific behaviors by refreshing browser, summarized in the diagram below with red arrows, who can be redefined with some "config.attributes":
- Modifications on localeapp.com:
By default, when a development environment page is refreshed, any validated translations will be sent to RoR project .
This behavior can be modified in file config/initializers/localeapp.rb, with:
config.polling_environments = []
- Modifications on local RoR project:
By default, when a development environment page is refreshed, every new translation key will be sent to localeapp.com.
Indeed, gem locale catch every Translation Missing Key, and send it to localeapp.com
This behavior can be modified in file config/initializers/localeapp.rb, with:
config.sending_environments = []
These behaviors are specifics to Ruby on Rails project because gem localeapp use error "Translation Key Missing", raised by Ruby on Rails.
