Changes between Version 4 and Version 5 of OSGeoLive_Translation_Process


Ignore:
Timestamp:
20 Dec 2017 14:01:19 (14 months ago)
Author:
bakaniko
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • OSGeoLive_Translation_Process

    v4 v5  
    6565## Build the doc
    6666make doc
    67 cd ..}}}
     67cd ..
     68}}}
    6869
    6970== Downloading translation ==
     
    102103Viewing your language html will help to put strings in context and/or check the translation.
    103104
    104 {{{tools/transifex/create_translations.sh fr}}}
     105{{{
     106tools/transifex/create_translations.sh fr
     107}}}
    105108The French documentation would be in
    106109
    107 {{{build/doc/html/fr/doc/index.html}}}
     110{{
     111{build/doc/html/fr/doc/index.html
     112}}}
    108113
    109114== Transifex files that are not accepting translations. ==
     
    127132Don't use "translate" button on stand alone references like
    128133
    129 {{{en:  :ref:`sample`
    130 ja:  :ref:`サンプル`    <--- wrong}}}
     134{{{
     135en:  :ref:`sample`
     136ja:  :ref:`サンプル`    <--- wrong
     137}}}
     138
    131139== Use a "suggestion" ==
    132140
     
    140148Copy the the stand alone references like
    141149
    142 {{{en:  :ref:`sample`
    143 ja:  :ref:`sample`}}}
     150{{{
     151en:  :ref:`sample`
     152ja:  :ref:`sample`
     153}}}
     154
    144155== Type a translation ==
    145156
     
    162173If the file you modified in transifex is doc--src--changelog--index and want to check the Japanese translation
    163174
    164 {{{tools/transifex/download_translation.sh ja pgrouting.doc--src--changelog--index
    165 tools/transifex/create_translations.sh ja}}}
     175{{{
     176tools/transifex/download_translation.sh ja pgrouting.doc--src--changelog--index
     177tools/transifex/create_translations.sh ja
     178}}}
    166179Navigate to the the translated file, for this example it would be
    167180
    168 {{{build/doc/html/ja/doc/src/changelog/index.html}}}
     181{{{
     182build/doc/html/ja/doc/src/changelog/index.html
     183}}}
    169184Notice the relation between names:
    170185
    171 {{{Transifex name:              pgrouting.doc--src--changelog--index
    172 Html Generated File: build/doc/html/ja/doc/src/changelog/index.html}}}
     186{{{
     187Transifex name:              pgrouting.doc--src--changelog--index
     188Html Generated File: build/doc/html/ja/doc/src/changelog/index.html
     189}}}
    173190And visualy compare the "looks" with the [English version] (http://docs.pgrouting.org/2.0/en/doc/index.html)
    174191
     
    181198Example:
    182199
    183 {{{html:    上記クエリは サンプルデータ のネットワークを使用しています。   <-- sample data is translated
    184 or:      上記クエリは Sample Data のネットワークを使用しています。   <--- sample data needs translation}}}
     200{{{
     201html:    上記クエリは サンプルデータ のネットワークを使用しています。   <-- sample data is translated
     202or:      上記クエリは Sample Data のネットワークを使用しています。   <--- sample data needs translation
     203}}}
    185204If you can navigate the links, you are ok
    186205
     
    250269Example
    251270
    252 {{{en:      The queries use the :ref:`sampledata` network.
     271{{{
     272en:      The queries use the :ref:`sampledata` network.
    253273ja:      上記クエリは :ref:`sampledata` のネットワークを使用しています。 
    254 html:    上記クエリは Sample Data のネットワークを使用しています。}}}
     274html:    上記クエリは Sample Data のネットワークを使用しています。
     275}}}
     276
    255277Thats 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.
    256278
     
    259281Example
    260282
    261 {{{en:      The queries use the :ref:`sampledata` network.
     283{{{
     284en:      The queries use the :ref:`sampledata` network.
    262285ja:      The queries use the :ref:`sampledata` network.
    263 html:    The queries use the サンプルデータ  network.}}}
     286html:    The queries use the サンプルデータ  network.
     287}}}
     288
    264289Maybe you navigated into an untranslated page that has a reference to a translated page.
    265290
     
    269294Example
    270295
    271 {{{en:      The queries use the :ref:`sampledata` network.
     296{{{
     297en:      The queries use the :ref:`sampledata` network.
    272298ja:      上記クエリは: ref:'sampledata'のネットワークを使用しています。   
    273 html:    上記クエリは: ref:'sampledata'のネットワークを使用しています。}}}
     299html:    上記クエリは: ref:'sampledata'のネットワークを使用しています。
     300}}}
     301
    274302The link's generated by the button need to be corrected, I suggest to copy the link together with its sorrounding spaces from the English version:
    275303
     
    286314Inline literals [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:
    287315
    288 {{{``int4`` id of the end point
     316{{{
     317``int4`` id of the end point
    289318``int4``型の始点ノードのID         <--- this will generate the error
    290319``int4 `` 型の始点ノードのID       <--- this will also generate the error (a space is after the 4)
    291 ``int4`` 型の始点ノードのID        <--- a space is (before as a new line and) after the inline literal}}}
     320``int4`` 型の始点ノードのID        <--- a space is (before as a new line and) after the inline literal
     321}}}
     322
    292323= Tools for the Reviewer =
    293324
     
    306337To download all language translations:
    307338
    308 {{{tools/transifex/download_translation.sh}}}
     339{{{
     340tools/transifex/download_translation.sh
     341}}}
    309342To download all the translations of a particular language:
    310343
    311 {{{tools/transifex/download_translation.sh [es|ja|fr|de]}}}
     344{{{
     345tools/transifex/download_translation.sh [es|ja|fr|de]
     346}}}
    312347To download the translation of a specific file you need to state the language also
    313348
    314 {{{tools/transifex/download_translation.sh [es|ja|fr|de] [pgrouting.<filename>]}}}
     349{{{
     350tools/transifex/download_translation.sh [es|ja|fr|de] [pgrouting.<filename>]
     351}}}
    315352
    316353== tools/transifex/create_translations.sh ==