Adding new languages

If the language you're trying to translate is not yet in OpenBoxes or Crowdin, the following instructions outline how to get the language added.

Requesting a new language

If you're not a project administrator, get in contact with us by posting to the OpenBoxes Slack, adding a post to our community forums, or by creating a new GitHub Issue. Let us know the language that you'd like to translate and we'll get you set up as quickly as possible.

Adding a new language

If you're a project administrator, the following are instructions on how to add a new langugage into OpenBoxes and make it translatable in Crowdin.

Adding a language to Crowdin

Translated languages in Crowdin are known as "target languages". To add a new target language, navigate to the project settings > Languages, then simply select any new langugages that we want to support.

This should cause Crowdin to automatically create a pull request into the openboxes repository containing a new messages.properties file for the language.

See Crowdin's documentation for additional information.

The following video covers everything required to configure Crowdin (plus also explains how the In-Context feature works):

Adding a language to OpenBoxes

Edit the application.yml file and add the two letter locale code of the new language to the supportedLocales property:

openboxes:
    locale:
        supportedLocales: [...]

After redeploying the application, the new language should be selectable in the list of locales in the website footer.