i18n.txt 2.18 KB
Newer Older
1
2
aurweb Translation
==================
Loui Chang's avatar
Loui Chang committed
3

4
5
This document describes how to create and maintain aurweb translations. It was
originally derived from https://wiki.archlinux.org/index.php/aurweb_Translation
Loui Chang's avatar
Loui Chang committed
6

7
8
9
Creating an aurweb translation requires a Transifex (http://www.transifex.com/)
account. You will need to register with a translation team on the aurweb
project page (http://www.transifex.com/projects/p/aurweb/).
Loui Chang's avatar
Loui Chang committed
10
11
12


Creating a New Translation
13
--------------------------
Loui Chang's avatar
Loui Chang committed
14

15
Before beginning, please sign up for an Transifex account and request the
16
addition of a new translation team for the aurweb 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 aurweb is a rapidly evolving project
19
20
21
and there are constantly new strings to be translated. If the translations get
too out of sync with the released versions, there will be too many untranslated
strings for the translation to be usable, and it may have to be disabled.
Loui Chang's avatar
Loui Chang committed
22

23
1. Check out the aurweb source using git:
Loui Chang's avatar
Loui Chang committed
24

25
$ git clone git://projects.archlinux.org/aurweb.git aurweb-git
Loui Chang's avatar
Loui Chang committed
26

27
28
2. Go into the "po/" directory in the aurweb source and run msginit(1) to
   create a initial translation file from our translation catalog:
Loui Chang's avatar
Loui Chang committed
29
30

$ cd aur-git
Loui Chang's avatar
Loui Chang committed
31
32
$ git checkout master
$ git pull
33
34
$ cd po
$ msginit -l <locale> -o <locale>.po -i aur.pot
Loui Chang's avatar
Loui Chang committed
35

36
3. Use some editor or a translation helper like poedit to add translations:
37

38
$ poedit <locale>.po
Loui Chang's avatar
Loui Chang committed
39

40
5. If you have a working aurweb setup, add a line for the new translation in
41
   "web/lib/config.inc.php.proto" and test if everything looks right.
Loui Chang's avatar
Loui Chang committed
42

43
44
6. Upload the newly created ".po" file to Transifex. If you don't like the web
   interface, you can also use transifex-client to do that (see below).
Loui Chang's avatar
Loui Chang committed
45
46
47


Updating an Existing Translation
48
--------------------------------
Loui Chang's avatar
Loui Chang committed
49

50
51
1. Download current translation files from Transifex. You can also do this
   using transifex-client which is available through the AUR:
Loui Chang's avatar
Loui Chang committed
52

Dan McGee's avatar
Dan McGee committed
53
$ tx pull -a
Loui Chang's avatar
Loui Chang committed
54

55
2. Update the existing translation file using an editor or a tool like poedit:
Loui Chang's avatar
Loui Chang committed
56

Dan McGee's avatar
Dan McGee committed
57
$ poedit po/<locale>.po
Loui Chang's avatar
Loui Chang committed
58

59
60
3. Push the updated translation file back to Transifex. Using transifex-client,
   this works as follows:
Loui Chang's avatar
Loui Chang committed
61

62
$ tx push -r aur.aurpot -t -l <locale>