IYE - short for I18N YAML Editor - makes it easy to translate your Rails I18N files and keep them up to date. Unlike a lot of other tools in this space, IYE works directly on the YAML files instead of keeping a separate database in sync. This has several benefits:
- Branching and diffing is trivial
- It does not alter the workflow for developers etc., whom can continue editing the YAML files directly
- If your YAML files are organized in subfolders, this structure is kept intact
You need to understand a few things about IYE for it to make sense, mainly:
- IYE does not create new keys - keys must exist for at least one locale in the YAML files
- IYE does not create new locales - at least one key must exist for each locale in the YAML files
-
Install IYE:
$ gem install iye -
Navigate to the folder containing your YAML files and start IYE:
$ iye .At this point IYE loads all translation keys for all locales, and creates any keys that might be missing for existing locales.
-
Point browser at http://localhost:5050
-
Make changes and press 'Save' - each time you do this, all the keys will be written to their original YAML files, which you can confirm e.g. by using
git diff.
The source ships with a config.ru suitable for development use with shotgun(1):
shotgun -p 5050
psych.rb:203:in `parse': wrong number of arguments(2 for 1) (ArgumentError)
: This is caused by a mismatch of the psych in standard library and the gem. The bug is fixed in Ruby 1.9.3-p194.