Internationalization

Conductor uses the fast_gettext: https://github.com/grosser/fast_gettext and fast_gettext integration gem for rails gettext_i18n_rails : https://github.com/grosser/gettext_i18n_rails

Using fast_gettext

to translate a string use

_("Foo")
to translate string with a parameter use _("Bar %s") % param
to translate string with more than one parameters use

_("Foo %s and %s") % [param1, param2] OR _("Params %{a} and %{b}") % {:a => "Foo", :b => "Bar"}
tell to gettext - this string need translation (found during parsing, usage i.e. constant string, validation messages)

N_("FooBar")
to translate pluralized

n_("Apple","Apples",count)

For date and time we use default Rails i18n API.

t('datetime.distance_in_words.x_months', :count => months)

All default translation dictionary is located in src/config/locales/default/en.yml

Be sure that added string contains no interpolation.

i.e. for instance states we used

t("instances.states.#{instance.state}")

but it have to be like for gettext format

_(instance.state)

where all states are defined somewhere in project (via gettext method N*). Be sure that your string followed PO file entry’s schematic structure:

msgid untranslated-string
msgstr translated-string

then to add new attributes to .pot/.po files rake gettext:find

If you want to create new .po file for specific language use rake gettext:add_language[de]
New translations will be marked fuzzy, search for this and remove it, so that they will be used . Obsolete translations are marked with ~#, they usually can be removed since they are no longer needed.

We are using Zanata project https://translate.zanata.org/zanata/ . Here you can find information about starting to contribute in translations.

Export/Import dictionaries to/from Zanata project

Zanata accepts PO file format.

Prerequisites

has an account in FAS
be a maintainer of https://translate.zanata.org/zanata/project/view/aeolus- conductor
when you’re a maintainer need to set USERNAME and KEY zanata.ini in your ~/.config/zanata.ini
installed zanata-python-client - command line tool for working with Zanata

Export

Create a new version of aeolus-conductor $ zanata version create VERSION*#
Set languages that EN.YML will be translated to, then download ZANATA.XML (AFAIK It can be downloaded only through UI)
Push to Zanata(from dir where you have ZANATA.XML file stored)

$ zanata push --project-type podir --srcdir path_to_directory_with_po_files

Import

Pull from Zanata(from dir where you have ZANATA.XML file stored)

$ zanata pull --project-type podir

Only admin of Zanata project can upload the dictionaries for translation, for more questions please ask on IRC #aeolus.