Sha256: a83af207b1693d89e433da5889e1fb86d8a6f979e2ed24f1e72d60870b7b3987

Contents?: true

Size: 1.77 KB

Versions: 5

Compression:

Stored size: 1.77 KB

Contents

# Managing translations (i18n)

## The workflow

Decidim uses [Crowdin](https://crowdin.com/) to manage the translations.

- Whenever someone [adds a new translation key](https://github.com/decidim/decidim/pull/1814/files#diff-c78c80097da59920d55b3f462ca21afaR177) to _Decidim_, _Crowdin_ gets notified and the new content is available to be translated from [Crowdin's Decidim dashboard](https://crowdin.com/project/decidim).
- When a translator translates any key from Crowdin, it automatically creates a [PR in Github](https://github.com/decidim/decidim/pulls?utf8=%E2%9C%93&q=is%3Apr%20author%3Adecidim-bot%20Crowdin), adding the keys in the corresponding _yaml_ files.
- 🌈

## Adding a new language

- Setup the new language in [_Crowdin's Decidim project_](https://crowdin.com/project/decidim) (or open an issue on Github asking an admin to do that).
- Translate at least one key from every engine, so, your _yaml_ files are not empty. The easiest way to do this is to automatically translate and sync all the content. Later you'll be able to fix the content that wasn't properly translated.
- Add [Foundation Datepicker](https://github.com/najlepsiwebdesigner/foundation-datepicker/tree/master/js/locales)'s translations ([PR](https://github.com/decidim/decidim/pull/2039)).
- Add Select2 translations ([PR](https://github.com/decidim/decidim/pull/2214)).
- Add the new language to `available_locales` ([PR](https://github.com/decidim/decidim/pull/1991)).
- Announce the new language in the Readme ([PR](https://github.com/decidim/decidim/pull/2125)).

## Test the new language

- Generate the development app and `cd` into it.
- Change the `config/initializer/decidim.rb` file and add your locale to `Decidim.available_locales`.
- `rake db:drop db:setup` to drop, create, load schema and seed the DB.

Version data entries

5 entries across 5 versions & 1 rubygems

Version Path
decidim-0.8.4 docs/managing_translations_i18n.md
decidim-0.8.3 docs/managing_translations_i18n.md
decidim-0.8.2 docs/managing_translations_i18n.md
decidim-0.8.1 docs/managing_translations_i18n.md
decidim-0.8.0 docs/managing_translations_i18n.md