docs-antora/modules/development/pages/updating_translations_launchpad.adoc

   1 = Updating translations using Launchpad =
   2 :toc:
   3
   4 This document describes how to update the translations in an Evergreen branch
   5 by pulling them from Launchpad, as well as update the files to be translated
   6 in Launchpad by updating the POT files in the Evergreen master branch.
   7
   8 == Prerequisites ==
   9 You must install all of the Python prerequisites required for building
  10 translations, per
  11 http://evergreen-ils.org/dokuwiki/doku.php?id=evergreen-admin:customizations:i18n
  12
  13 * https://bitbucket.org/izi/polib/wiki/Home[polib]
  14 * http://translate.sourceforge.net[translate-toolkit]
  15 * http://pypi.python.org/pypi/python-Levenshtein/[levenshtein]
  16 * http://pypi.python.org/pypi/setuptools[setuptools]
  17 * http://pypi.python.org/pypi/simplejson/[simplejson]
  18 * http://lxml.de/[lxml]
  19
  20 == Updating the translations ==
  21
  22 . Check out the latest translations from Launchpad by branching the Bazaar
  23 repository:
  24 +
  25 [source,bash]
  26 ------------------------------------------------------------------------------
  27 bzr branch lp:~denials/evergreen/translation-export
  28 ------------------------------------------------------------------------------
  29 +
  30 This creates a directory called "translation-export".
  31 +
  32 . Ensure you have an updated Evergreen release branch.
  33 . Run the `build/i18n/scripts/update_pofiles` script to copy the translations
  34   into the right place and avoid any updates that are purely metadata (dates
  35   generated, etc).
  36 . Commit the lot! And backport to whatever release branches need the updates.
  37 . Build updated POT files:
  38 +
  39 [source,bash]
  40 ------------------------------------------------------------------------------
  41 cd build/i18n
  42 make newpot
  43 ------------------------------------------------------------------------------
  44 +
  45 This will extract all of the strings from the latest version of the files in
  46 Evergreen.
  47 +
  48 . (This part needs automation): Then, via the magic of `git diff` and `git add`,
  49 go through all of the changed files and determine which ones actually have
  50 string changes. Recommended approach is to re-run `git diff` after each
  51 `git add`.
  52 . Commit the updated POT files and backport to the pertinent release branches.