Translation Check your work

This step is needed not to check the translation but to check that ReStructuredText that is in the translated strings is correct. Many things might be wrong, an extra space, a missing space a missing character "`" .

Download the translated file and recreate the translation

If the file you modified in transifex is doc--src--changelog--index and want to check the French translation

tools/transifex/download_translation.sh fr pgrouting.doc--src--changelog--index
tools/transifex/create_translations.sh fr

Navigate to the the translated file, for this example it would be

build/doc/html/fr/doc/src/changelog/index.html

And visualy compare the "looks" with the [english version] (http://docs.pgrouting.org/2.0/en/doc/index.html)

Trouble shooting

Please post any question in issue 200

The :ref: link is not translated

If you copied the link, and you haven't translated the referenced page, you will still see the link in English but you can navigate to the page.

I don't see the link but I can read :ref: in the html page

This is a common problem when using the translation button. Example: For the string

Go to :ref:\`nameoflink\` and read

We get

Ir a: ref:'nameoflink'y leer    <--- bad spacing and bad ` symbol

It should be:

Ir a :ref:\`nameoflink\` y leer

The fastest way is to copy/paste the link and check the spacing before and after.

WARNING: Inline literal start-string without end-string.

This error is generated when using tools/transifex/create_translations.sh. Languages like Japanese that don't use spaces to separate words are more likely to have this error. Unfortunately the error is shown only in line 1.

Inline literas [specs] (http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#inline-markup) require a space before and after. The inline literals we use the most are of the type ``inlineliteral`` like in:

``int4`` id of the end point
``int4``型の始点ノードのID         <--- this will generate the error
``int4 `` 型の始点ノードのID       <--- this will also generate the error (a space is after the 4)
``int4`` 型の始点ノードのID        <--- a space is (before as a new line) and after the inline literal