I18n is an internationalization module for Crystal.

Installation

Add this to your application's shard.yml:

dependencies:
  i18n:
    github: vladfaust/i18n.cr
    version: ~> 0.1.0

Documentation

Documentation is avalilable online.

Usage

# es.yml
es:
  apples:
    one: 1 manzana
    other: "%{count} manzanas"

require "i18n"
require "i18n/backends/yaml"

I18n.backend = I18n::Backends::YAML.new.tap do |backend|
  backend.load_paths << Dir.current + "/locales"
  backend.load
end

I18n.default_locale # => "en"
I18n.locale = "es"

I18n.t("apples", count: 3) # => "3 manzanas"

You can implement your own I18n::Backend, as well as your own quantity keys rules ("one", "many" etc.). Read more in docs.

Development

Tests included! Run crystal spec while developing.

There is currently no code for localization currencies, date and time etc. If you need it, please open an issue and/or a pull request.

Contributing

1. Fork it ( https://github.com/vladfaust/i18n.cr/fork )
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create a new Pull Request

Contributors

• @vladfaust Vlad Faust - creator, maintainer

Credits

• Logo font: HVD Comic Serif Pro
• Logo image: EmojiOne