Sha256: abfb7827647d3d91d101c93f7d88dfa77fe244b4fc385da5f380e11b8df19379

Contents?: true

Size: 1.74 KB

Versions: 28

Compression:

Stored size: 1.74 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).
- Add the locale mapping in the `crowdin.yml` file
- 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 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

28 entries across 28 versions & 1 rubygems

Version Path
decidim-0.17.2 docs/advanced/managing_translations_i18n.md
decidim-0.17.1 docs/advanced/managing_translations_i18n.md
decidim-0.16.1 docs/advanced/managing_translations_i18n.md
decidim-0.17.0 docs/advanced/managing_translations_i18n.md
decidim-0.16.0 docs/advanced/managing_translations_i18n.md
decidim-0.15.2 docs/advanced/managing_translations_i18n.md
decidim-0.15.1 docs/advanced/managing_translations_i18n.md
decidim-0.15.0 docs/advanced/managing_translations_i18n.md
decidim-0.14.4 docs/advanced/managing_translations_i18n.md
decidim-0.14.3 docs/advanced/managing_translations_i18n.md
decidim-0.14.2 docs/advanced/managing_translations_i18n.md
decidim-0.14.1 docs/advanced/managing_translations_i18n.md
decidim-0.13.1 docs/advanced/managing_translations_i18n.md
decidim-0.12.2 docs/advanced/managing_translations_i18n.md
decidim-0.13.0 docs/advanced/managing_translations_i18n.md
decidim-0.12.1 docs/advanced/managing_translations_i18n.md
decidim-0.13.0.pre1 docs/advanced/managing_translations_i18n.md
decidim-0.12.0 docs/advanced/managing_translations_i18n.md
decidim-0.11.2 docs/advanced/managing_translations_i18n.md
decidim-0.12.0.pre docs/advanced/managing_translations_i18n.md