Translation Process

The general process pgRouting use 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.
• When all the *.pot files have been translated into a language, the mantainers proceed to download the generated *.po files that contain the translated strings
• A little bit of process and we ale able to generate the html, man, pdf for the language downloaded.

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.

The Translators Process

• Tools for the Translator
• [Before you start] (Translation Before you start)
• [Working with small strings](Translations Working with small strings)
• [Check your work](Translation Check your work)
• [Troubleshooting](Translation troubleshooting)