Last updated: 16 Dec 2020
Add support for a new translation in Whitehall
Useful links:
1. Update Government Frontend
- Add the new locale to
config/application.rb
andconfig/locales/en.yml
in alphabetical order -
Run the following commands to generate the locale files from the English template:
$ export LOCALE=<new_locale> $ rake "translation:export[tmp/locale_csv,en,${LOCALE}]" $ rake "translation:import[${LOCALE},tmp/locale_csv/${LOCALE}.csv]"
-
In
config/locales/<new_locale>.yml
add the language translation under thelanguage_names
key.For example:
it: language_names: it: italiano
2. Update Whitehall
In Whitehall:
- Add the new locale to
lib/whitehall.rb
andconfig/locales/en.yml
in alphabetical order -
Run the following commands to generate the locale files from the English template:
$ export LOCALE=<new_locale> $ rake "translation:export[tmp/locale_csv,en,${LOCALE}]" $ rake "translation:import[${LOCALE},tmp/locale_csv/${LOCALE}.csv]"
- In
config/locales/<new_locale>.yml
add:- the language direction under the
i18n.direction
key - the appropriate boolean under the
i18n.latin_script?
key - the language translation under the
language_names
key
For example:
it: i18n: direction: ltr latin_script?: true language_names: it: Italiano
- the language direction under the
3. Update GOV.UK Content Schemas
- Edit
formats/shared/definitions/locale.jsonnet
to include the new locale in alphabetical order - Run
rake
to generate all the schemas
4. Update Content Store
In Content Store:
- Add the locale key to
config/application.rb
in alphabetical order
5. Update Publishing API
In Publishing API:
- Add the locale key to
config/application.rb
in alphabetical order