*.pot files are generated.*.pot files are used by [https://www.transifex.com/osgeo/osgeolive Transifex] and they contain only the strings that need to be translated.*.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 fr
*.po files of your language based on translation percentage.
{{{
tx pull -l fr --minimum-perc=100
}}}
* Ask for help:
{{{
tx pull --help
}}}
=== Checking the download ===
{{{
git status
}}}
A possible output:
== Have your language documentation html open. ==
Viewing your language html will help to put strings in context and/or check the translation.
{{{
tools/transifex/create_translations.sh fr
}}}
The French documentation would be in
{{{
build/doc/html/fr/doc/index.html
}}}
== Transifex files that are not accepting translations. ==
Files not accepting translations are marked with a red dot, maybe the file belongs to a previous version of OSGeo-Live documentation, or it was moved from one directory to another. Those files are not erased from the system s
o any translated string can be reused.
== English spelling and grammar ==
Sometimes the developers and the reviewers have typos in the English version, you will see spelling typos with a wavy red line, unfortunately it is too late to correct them for the current version. So proceed with the transla
tion with the best of your ability. For the grammar, if you don't understand what is being told, please go to [https://github.com/pgRouting/pgrouting/issues/200 issue 200] to post a comment stating the file and pasting the En
glish string. If a change has been considered, the string to be translated will be posted on the "instructions" for the string.
= Working with small strings =
== Choose the small files first. ==
For "small" I mean the ones that have very few strings to be translated. That will start building up a bank of translated strings that can be used in larger files. To detect a "small" file go to the list o
f [resources] (https://www.transifex.com/projects/p/pgrouting/resources/) and choose a file with few words or few strings.
== Use "translate" button ==
The "translate button" comes quite handy, you still have to check the translation, and there is an "undo" button if you think that its better for you to type the translation than to modify the machine's tr
anslation.
Don't use "translate" button on stand alone references like
{{{
en: :ref:`sample`
ja: :ref:`サンプル` <--- wrong
}}}
== Use a "suggestion" ==
When you work with transifex it builds up a translated string bank and it will show one or more suggestions. If the suggestion is very close to what is needed, use it, and change the translation to the final translation of th
e string. Example:
{{{
en: :ref:`pgr_astar<pgr_astar>` - Shortest Path A*
Use suggestion: pgr_astar - A*アルゴリズムを用いた最短経路探索
Modify to: :ref:`pgr_astar<pgr_astar>` - A*アルゴリズムを用いた最短経路探索
}}}
== Use "copy button" ==
Copy the the stand alone references like
{{{
en: :ref:`sample`
ja: :ref:`sample`
}}}
== Type a translation ==
You can just type your translation.
== Go to the next string ==
When you finished translating the string press "tab", that way it get's saved, if you click to a different string, maybe because the next string is already translated, then it won't be saved (green/white stripes).
== Save your translation ==
Make sure all strings using the "Save all unsaved translations" button.
= Check your work =
This step is needed not to check the translation but to check that ReStructuredText in the translated strings is correct. Many things might be wrong, an extra space, a missing space or 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 Japanese translation
{{{
tools/transifex/download_translation.sh ja pgrouting.doc--src--changelog--index
tools/transifex/create_translations.sh ja
}}}
Navigate to the the translated file, for this example it would be
{{{
build/doc/html/ja/doc/src/changelog/index.html
}}}
Notice the relation between names:
{{{
Transifex name: pgrouting.doc--src--changelog--index
Html Generated File: build/doc/html/ja/doc/src/changelog/index.html
}}}
And visualy compare the "looks" with the [English version] (http://docs.pgrouting.org/2.0/en/doc/index.html)
== Use the "Approve translation" button ==
When the file is fully translated (except the navigation bar), you can are about to approve the translation, '''????????'''
* Check the links first, example: there is a link to sample data.
Example:
{{{
html: 上記クエリは サンプルデータ のネットワークを使用しています。 <-- sample data is translated
or: 上記クエリは Sample Data のネットワークを使用しています。 <--- sample data needs translation
}}}
If you can navigate the links, you are ok
* When using create_translation script there was no "inline" error (see [[Translation Troubleshooting]] ), you are ok
If you are ok, then choose a string and click the "Approve translation" button.
= Which file is next =
== Do doc--index last ==
That way you can use the "Use suggestion" in this file.
== Work "important" files first ==
All files are important, but the following files are the core of the project. Most of them have repeated strings, so the "Use Suggestion" tactic is perfect, and you can use the search box to find them.
- your project files: you know that project certainly better than us, especially in your language; starting by the overview then the quickstart
- OSGeoLive files: there is several core files for the OSgeoLive documentation:
- index
- overview--overview
- overview--toc
- quickstart--virtualization_quickstart
- quickstart--usb_quickstart
- quickstart--osgeolive_quickstart
- copyright
- contributors
- translators
- presentation
- sponsors
etc
They are listed with a red double ">" priority sign
== Work the "almost finished" files ==
After you finish a file, you can choose a file that is "almost done". I found pretty uncomfortable the list placed at the left, so to choose an almost done file I recommend:
* Click Documentation
* Click on your language
* click on the sorting button (sorts by % of termination)
This is very useful when you have a lot of files already translated
== Work files that belong to a directory ==
Based on the following files:
* doc--src--changelog--1_x ... 150 words (25 strings) ...
* doc--src--changelog--2_0 ... 277 words (26 strings) ...
* doc--src--changelog--index ... 4 words (3 strings) ...
Maybe you started working with doc--src--changelog--index, so the next step would be to work with
* doc--src--changelog--1_x
* doc--src--changelog--2_0
So you finished a section, go [[Translation Check your work]].
= Troubleshooting =
Please post any question in [https://github.com/pgRouting/pgrouting/issues/200 issue 200]
== The :ref:`nameoflink` link is not translated ==
Example
{{{
en: The queries use the :ref:`sampledata` network.
ja: 上記クエリは :ref:`sampledata` のネットワークを使用しています。
html: 上記クエリは Sample Data のネットワークを使用しています。
}}}
Thats and indication that the referenced page for Sample Data, isn't fully translated. If you can click on the link and navigate you are ok.
== The :ref:`nameoflink` link is the only thing that is translated ==
Example
{{{
en: The queries use the :ref:`sampledata` network.
ja: The queries use the :ref:`sampledata` network.
html: The queries use the サンプルデータ network.
}}}
Maybe you navigated into an untranslated page that has a reference to a translated 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.*.po files that are in your system with the latest translation stored in Transifex.*.po files stored in your system. Languages available:
* es - Spanish
* fr - French
* ja - Japanese
* de - German
To create the documentation of all the languages
{{{
tools/transifex/create_translations.sh
}}}
To create the documentation of a particular language:
{{{
tools/transifex/create_translations.sh [es|ja|fr|de]
}}}
The main index.html of the documentation will be located at:
{{{
build/doc/html/[es|ja|fr|de]/doc/index.html
}}}
= Main wiki page =
* [https://trac.osgeo.org/osgeolive/wiki OSGeoLive wiki]