Repository for collecting Locale data for Ruby on Rails I18n as well as other interesting, Rails related I18n stuff
Centralization of locale data collection for Ruby on Rails.
Include the gem to your Gemfile:
gem 'rails-i18n', '~> 6.0.0' # For 6.0.0 or higher gem 'rails-i18n', '~> 5.1' # For 5.0.x, 5.1.x and 5.2.x gem 'rails-i18n', '~> 4.0' # For 4.0.x gem 'rails-i18n', '~> 3.0' # For 3.x gem 'rails-i18n', github: 'svenfuchs/rails-i18n', branch: 'master' # For 5.x gem 'rails-i18n', github: 'svenfuchs/rails-i18n', branch: 'rails-4-x' # For 4.x gem 'rails-i18n', github: 'svenfuchs/rails-i18n', branch: 'rails-3-x' # For 3.x
Alternatively, execute the following command:
gem install rails-i18n -v '~> 6.0.0' # For 6.0.0 or higher gem install rails-i18n -v '~> 5.1' # For For 5.0.x, 5.1.x and 5.2.x gem install rails-i18n -v '~> 4.0' # For 4.0.x gem install rails-i18n -v '~> 3.0' # For 3.x
Note that your Ruby on Rails version must be 3.0 or higher in order to install the
rails-i18ngem. For rails 2.x, install it manually as described in the Manual Installation section below.
rails-i18ngem initially loads all available locale files, pluralization and transliteration rules. This default behaviour can be changed. If you specify in
config/environments/*the locales which have to be loaded via
config.i18n.available_locales = ['es-CO', :de]
config.i18n.available_locales = :nl
Download desired locale files found in rails/locale directory and move them into the
config/localesdirectory of your Rails application.
If any translation doesn't suit well to the requirements of your application, edit them or add your own locale files.
For more information, visit Rails Internationalization (I18n) API on the RailsGuides.
Locale data whose structure is compatible with Rails 2.3 are available on the separate branch rails-2-3.
af, ar, az, be, bg, bn, bs, ca, cs, cy, da, de, de-AT, de-CH, de-DE, el, el-CY, en, en-AU, en-CA, en-GB, en-IE, en-IN, en-NZ, en-US, en-ZA, en-CY, en-TT, eo, es, es-419, es-AR, es-CL, es-CO, es-CR, es-EC, es-ES, es-MX, es-NI, es-PA, es-PE, es-US, es-VE, et, eu, fa, fi, fr, fr-CA, fr-CH, fr-FR, gl, he, hi, hi-IN, hr, hu, id, is, it, it-CH, ja, ka, km, kn, ko, lb, lo, lt, lv, mk, ml, mn, mr-IN, ms, nb, ne, nl, nn, oc, or, pa, pl, pt, pt-BR, rm, ro, ru, sk, sl, sq, sr, st, sw, ta, te, th, tl, tr, tt, ug, ur, uz, vi, wo, zh-CN, zh-HK, zh-TW, zh-YUE
af, da, de, de-AT, de-CH, de-DE, en-US, es, es-419, es-AR, es-CL, es-CO, es-CR, es-EC, es-ES, es-MX, es-NI, es-PA, es-PE, es-US, es-VE, et, fa, fr, fr-CA, fr-CH, fr-FR, id, ja, ka, ml, nb, nl, nn, pt, pt-BR, sv, sv-SE, tr, zh-CN, zh-HK, zh-TW, zh-YUE, uk
Currently, most locales are incomplete. Typically they lack the following keys:
The following keys should NOT be included:
We always welcome your contributions!
Some locales have the symbol of the currency (e.g.
€) under the key
number.currency.format.unit, while others have the code (e.g.
CHF). The value of the key depends on the widespread adoption of the unicode currency symbols by fonts.
For example the Turkish Lira sign (
₺) was recently added in Unicode 6.2 and while most popular fonts have a glyph, there are still many fonts that will not render the character correctly.
If you want to provide a different value, you can create a custom locale file under
config/locales/tr.ymland override the respective key:
tr: number: currency: format: unit: TL
If you are familiar with GitHub operations, then follow the procedures described in the subsequent sections.
svenfuchs/rails-i18nrepository and clone it into your PC.
rails/locale/en.yml, which should be used as the base of your translation.
Before committing and pushing your changes, test the integrity of your locale file. (You can also run the tests using Docker, see below)
bundle exec rake spec
Make sure you have included all translations with:
bundle exec rake i18n-spec:completeness rails/locale/en.yml rails/locale/YOUR_NEW_LOCALE.yml
Make sure it is normalized with:
thor locales:normalize LOCALE # or "thor locales:normalize_all"
You can list all complete and incomplete locales:
thor locales:complete thor locales:incomplete
Also, you can list all available locales:
You can list all missing keys:
i18n-tasks missing es
Add your locale name to the list in
README.mdif it isn't there.
If you are ready, push the repository into the Github and send us a pull request.
We will do the formality check and publish it as quick as we can.
If your pull request or issue concerns a specific locale - please indicate the relevant locale in the issue or pull request title in order to facilitate triage.
Danish: change da.errors.messages.required to "skal udfyldes"
Human precision in Swedish locale file is set to 1
Update es-PE.yml, the currency unit is incorrect
Changing some string about validation
Build the image:
docker build --tag=railsi18n .
Run the tests:
docker run railsi18n
To run the other commands described above:
docker run railsi18n bundle exec rake i18n-spec:completeness rails/locale/en.yml rails/locale/YOUR_NEW_LOCALE.yml
Tsutomu Kuroda for untiringly taking care of this repository, issues and pull requests