Translation Process - pgRouting/pgrouting GitHub Wiki

The general process pgRouting used for documentation:

  • The developer use ReStructuredText syntax to write the documentation.

  • That documentation is then used with Sphinx to generate the html, man, pdf,

  • Also using Sphinx-intl the *.pot files are generated.

  • Those *.pot files are used by Transifex and they contain only the strings that need to be translated.

  • Translator works with those strings using the process bellow.

  • When the translator finishes a language, the git hub mantainers proceed to download the generated *.po files that contain the translated strings and commit them in git hub and update the documentation page.

  • Users can create their translation using:

    tools/transifex/create_translation.sh jp

Translations to japanese are going to be used as examples along this wiki, I decided on japanese because that way you can focus on what is being translated and what is not.

Translation menu

Main wiki page