Project

iye

0.03
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
2025
2026
 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