How to Translate the Documentation

All documentation is written in English as the master language but can be translated into your native language. This write up will show you how to translate the documentation. There are different methods to translate the documentation and here we list a few.

Translate using Github Locally

Here we assume you have GitHub running locally and that you are familiar with the command line.

  1. Get latest version from GitHub:

    $ git pull
  2. Get latest version from Transifex (it should be synced with Github, but just in case):

    $ tx pull -a
  3. Edit your files for example (if using vi):

    $ vi i18n/it/LC_MESSAGES/index.po
  4. Build the documentation now, before committing and pushing, build the doc to see if everything worked smoothly:

    $ make html LANG=it
  5. Push changes if everything worked well, push the changes:

    $ tx push -s -t