Repo for translation
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

How to translate

We've got two parts: interface and content.

Everything is in open source on github.

Here's an example of how interface translations are kept:

Content is stored in as markdown files with lang extentions. E.g.

But we can't just translate these files and create pull requests because otherwise it'll be very hard to maintain updates.

So we need tooling to help us automate translation and get possibility to invalidate only updated parts.

There's a standard for it called XLIFF.

In short:

  1. Source content is splitted by phrases and stored in XLIFF format with additional file called skeleton.
  2. Each phrase is translated separately in XLIFF.
  3. Source structure is recreated with the help of skeleton.

So it looks like this: -> [ article.xliff, article.skl ] -> ->

We've got some scripts to do it but there's still some issues with them.

So for now we can translate the site this way:

  1. We generate and commit XLIFFs to repo.
  2. People who want to help with translation fork the repo and make translations. Then send PRs to source repo
  3. We generate translated markdowns and publish on

In the future we'll create web interface for such translations.