TRANSLATING

   1 AUR Translation
   2 ================
   3
   4 This document describes how to create and maintain AUR translations. It was
   5 originally derived from http://wiki.archlinux.org/index.php/AUR_Translation
   6
   7 Creating an AUR translation requires a Transifex (http://www.transifex.net/)
   8 account. You will need to register with a translation team on the AUR project
   9 page (http://www.transifex.net/projects/p/aur/).
  10
  11
  12 Creating a New Translation
  13 ---------------------------
  14
  15 Before beginning, please sign up for an Transifex account and request the
  16 addition of a new translation team for the AUR project. Also, please do not
  17 translate if you are unwilling to maintain or find someone to maintain the
  18 translation. This is due to the fact that the AUR is a rapidly evolving project
  19 and there are constantly new strings to be translated. If the translations get
  20 too out of sync with the released versions, there will be too many untranslated
  21 strings for the translation to be usable, and it may have to be disabled.
  22
  23 1. Check out the AUR source using git:
  24
  25 $ git clone git://projects.archlinux.org/aur.git aur-git
  26
  27 2. Go into the "po/" directory in the AUR source and run msginit(1) to create a
  28    initial translation file from our translation catalog:
  29
  30 $ cd aur-git
  31 $ git checkout master
  32 $ git pull
  33 $ cd po
  34 $ msginit -l <locale> -o <locale>.po -i aur.pot
  35
  36 3. Use some editor or a translation helper like poedit to add translations:
  37
  38 $ poedit <locale>.po
  39
  40 5. If you have a working AUR setup, add a line for the new translation in
  41    "web/lib/config.inc.php.proto" and test if everything looks right.
  42
  43 6. Upload the newly created ".po" file to Transifex. If you don't like the web
  44    interface, you can also use transifex-client to do that (see below).
  45
  46
  47 Updating an Existing Translation
  48 ---------------------------------
  49
  50 1. Download current translation files from Transifex. You can also do this
  51    using transifex-client which is available through the AUR:
  52
  53 $ tx pull -a
  54
  55 2. Update the existing translation file using an editor or a tool like poedit:
  56
  57 $ poedit po/<locale>.po
  58
  59 3. Push the updated translation file back to Transifex. Using transifex-client,
  60    this works as follows:
  61
  62 $ tx push -r aur.aurpot -t -l <locale>