Project

iye

0.04
Repository is archived
No commit activity in last 3 years
No release in over 3 years
There's a lot of open issues
I18n YAML Editor
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

>= 3
>= 1.3.4
>= 1.3
 Project Readme

IYE

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

IYE yaml editor

Prerequisites

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

Workflow

  1. Install IYE:

     $ gem install iye
    
  2. 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.

  3. Point browser at http://localhost:5050

  4. 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.

Development

The source ships with a config.ru suitable for development use with shotgun:

shotgun -p 5050

To run tests:

bundle install
bundle exec rake

Troubleshooting

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.

Build status