Translating Discourse with Transifex

Announcements Blog
2

Courtesy of @lidel, here is an easy process to get started translating Discourse in Transifex. Reprinted here with his permission.

My priority is to translate user-facing labels first, so I focus on client (client.*.yml) strings:

  1. Enable the selected language of your choice at your Discourse instance and start browsing it. We’ll call it by its language identifier, {LANG}

  2. When you find missing translation such as [{LANG}.categories.topics] copy its key name (categories.topics)

  3. Go to https://www.transifex.com/projects/p/discourse-org/language/{LANG} and click client.en.yml.

  4. A Pop-up will open, click Translate now.

  5. Translation interface should load and be ready for use.

  6. You can just start translating, but usually you don’t know the context, or just do not care that much about super-rare message and want to fix a specific label.

    That is why I search for strings with the Key: selector:

    • On top left you have a search box. Click there.

    • A handy pop-up with additional search criteria will show up.

    • Select Key: paste categories.topics and hit [Enter]

    • You should see that one result is found and it is already translated

And that is all.

Currently I repeat #6 for every missing label I see in my instance. I already filled most of irritating gaps, so it should be quite usable even at this stage.

If you want to fetch latest translation of client.en.yml there is Download for use link in the pop-up mentioned in step #4. Or just wait for upstream Discourse update.

6 Likes