/dry_i18n

A gem for not repeating yourself adding translations. It permits you to reuse I18n keys

Primary LanguageRubyMIT LicenseMIT

DryI18n

Installation

Add this line to your application's Gemfile:

gem 'dry_i18n'

And then execute:

$ bundle

Or install it yourself as:

$ gem install dry_i18n

Usage

With this Gem you'll be able tu reuse i18n key translations, avoiding in this way to repeat yourself.

Basically you just need to wrap the key you want to reuse with the markup @[key]

If the key you are reusing has interpolations, you just need to add a coma and pass a hash with the interpolation values @[key,{foo: 'foo', bar: 'bar'}]

You don't have to worry about the order you declare the keys on the yml files

###Some examples of usage:

1.- Basic reuse

en:
    secondary_key: "secondary key"
    main_key: "I am a main key which reuse a @[secondary_key]"
I18n.t("main_key") = "I am a main key which reuse a secondary key"

2.- Reusing with interpolation

en:
    secondary_key: "secondary key with %{interpolation}"
    main_key: "I am a main key which reuse a @[secondary_key,{interpolation: 'interpolation'}]"
I18n.t("main_key") = "I am a main key which reuse a secondary key with interpolation"

3.- Reusing with nested keys with or without interpolation

en:
    nth_key: "nested key with %{interpolation}"
    secondary_key: "secondary key with %{interpolation} and a @[nth_key,{interpolation: 'interpolation'}]"
    main_key: "I am a main key which reuse a @[secondary_key,{interpolation: 'interpolation'}], and it's own %{interpolation}"
I18n.t("main_key",{interpolation: 'interpolation'}) =
"I am a main key which reuse a secondary key with interpolation and a nested key with interpolation, and its own interpolation"

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/NachoPal/dry_i18n.

License

The gem is available as open source under the terms of the MIT License.