Skip to content

Internationalization

Forrest Evans edited this page Jun 3, 2020 · 3 revisions

Are you interested in translating Rundeck to another language? Thank you!

This is a short guide to contributing a translation to the Rundeck project.

Most (but not all) of the Rundeck web user interface can be internationalized using the Grails "messages.properties" file. Some strings are hardcoded in the gsp files still. If you see a location where a string is still hardcoded, please file an issue report.

Grails

Rundeck is based on Grails. If you want to read more about Grails internationalization, see this page.

How to

  1. Fork the rundeck project's "development" branch
  2. Duplicate the "messages.properties" file. This is located under "rundeckapp/grails-app/i18n/messages.properties", seen here.
  3. Name your file "messages_ll_CC.properties", using the Locale string, which is a two-letter language code, and optional two-letter country code. eg. "en_GB" or "es" (spanish), etc.
  4. Modify the file to add your translation.
  5. Add the file using git. git add rundeckapp/grails-app/i18n/messages_ll_CC.properties
  6. Commit the file using git. git commit rundeckapp/grails-app/i18n/messages_ll_CC.properties
  7. Push your branch back to github: git push origin development
  8. Send us a pull request with the new translation.