i18n-tasks  [![Build Status](https://travis-ci.org/glebm/i18n-tasks.png?branch=master)](https://travis-ci.org/glebm/i18n-tasks)
==========

Rails I18n tasks to find missing / unused translations and more. Works with slim / coffee / haml etc.

![i18n-missing-screenshot]

Use `rake -T i18n` to get the list of tasks with descriptions. There are 3 tasks available at the moment:

* `i18n:missing` task shows all the keys that have not been translated yet *([source](https://github.com/glebm/i18n-tasks/blob/master/lib/i18n/tasks/missing.rb))*
* `i18n:prefill` task normalizes locale files, and adds missing keys from base locale to others *([source](https://github.com/glebm/i18n-tasks/blob/master/lib/i18n/tasks/prefill.rb))*
* `i18n:unused` task shows potentially unused translations *([source](https://github.com/glebm/i18n-tasks/blob/master/lib/i18n/tasks/unused.rb))*

`i18n:unused` will detect pattern translations and not report them, e.g.:

    t 'category.' + category.key # 'category.arts_and_crafts' considered used
    t "category.#{category.key}" # also works

Relative keys (`t '.title'`) are supported too.

`i18n:missing` may incorrectly show framework i18n keys as missing, to work around this use `.i18nignore` file in project root:

    devise.errors.unauthorized # ignore this key
    pagination.views.          # ignore the whole pattern (note the .)

Keys listed in `.i18nignore` will also be excluded from `i18n:unused` report.

For more examples see [the tests](https://github.com/glebm/i18n-tasks/blob/master/spec/i18n_tasks_spec.rb#L43-L59).

Installation
------------

Simply add to Gemfile:

    gem 'i18n-tasks', '~> 0.0.8'

Configuration
-------------

By default reports I18n reads locale data from `config/locales/{locale_code}.yml`.
You can customize this, e.g.:

    # load all config/locales/*.locale.yml and config/locales/locale.yml:
    I18n::Tasks.get_locale_data = ->(locale) {
      (["config/locales/#{locale}.yml"] + Dir["config/locales/*.#{locale}.yml"]).inject({}) { |hash, path|
        hash.merge! YAML.load_file(path)
        hash
      }
    }

  [i18n-missing-screenshot]: https://raw.github.com/glebm/i18n-tasks/master/doc/img/i18n-missing.png "rake i18n:missing output screenshot"