Changes between Version 9 and Version 10 of TranslationSystem

Timestamp:

Jul 15, 2018, 7:56:12 AM (6 years ago)

Author:

Christian Beer

Comment:

Update documentation to current script

TranslationSystem

@@ -20 +20 @@
  || Android GUI || android/ || android/BOINC/res/values/strings.xml || android/BOINC/res/values-<lang>/strings.xml ||
 
-In order to update templates or translations one needs to have write permissions in the BOINC github repository and be a maintainer on the BOINC Transifex project. The tools '''xgettext, tx and pocompile''' (Debian packages: gettext, transifex-client, translate-toolkit) need to be installed to do the updates.
+In order to update templates or translations one needs to have write permissions in the BOINC github repository and be a maintainer on the BOINC Transifex project. The tools '''xgettext, tx, pofilter and pocompile''' (Debian packages: gettext, transifex-client, translate-toolkit) need to be installed to do the updates.
 The transifex client needs to be configured with credentials of your transifex account in order to use it (see: https://docs.transifex.com/client/client-configuration#-transifexrc).
 Android uses different language codes for regional languages so there is an additional mapping configured in '''.tx/config'''.
@@ -35 +35 @@
 == Template generation ==
 
-New templates are needed if translatable strings change in source code. The script '''locale/update_templates.sh''' generates the templates (except Drupal and Android), commits them to the repository and pushes them to Transifex. You can check the template generation by using the '''-t''' testmode switch. Transifex has a Translation Memory so pushing a faulty template does not remove existing translations. Just push a fixed template and translations will be recovered.
+New templates are needed if translatable strings change in source code. The script '''locale/update_templates.sh''' generates the templates (except Drupal and Android) and prepares them for commit. See script output for further manual steps. Transifex has a Translation Memory so pushing a faulty template does not remove existing translations. Just push a fixed template and translations will be recovered.
 
 Templates for Android and Drupal need to be committed and pushed to Transifex (use '''tx push -s''') separately.
 
-Projects can create templates for their project specific website using '''html/ops/build_po.php''' and send it to Transifex for translation too.
+Projects can create templates for their project specific website using '''html/ops/build_po.php''' and send it to Transifex for translation too. There needs to be project Transifex project first so contact the PMC first.
 
 == Translation ==
 
-New translations need to be downloaded from Transifex and committed into the BOINC Github repository using '''locale/update_translations.sh'''. Translations are only downloaded if they are 100% complete and already present in the repository. New translations need to be downloaded using '''tx pull -a'''.
+New translations need to be downloaded from Transifex and committed into the BOINC Github repository using '''locale/update_translations.sh'''. Translations are only downloaded if they are at least 97% complete and already present in the repository. New translations need to be downloaded using '''tx pull -a'''.
 
 '''Note:''' Transifex uses the timestamp of .po files to determine if new ones need to be downloaded. Since git updates timestamps when switching branches it may be necessary to force the download of translations ('''tx -f''') in order to get the newest ones.