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

4
This document describes how to create and maintain aurweb translations.
Loui Chang's avatar
Loui Chang committed
5

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


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

14
Before beginning, please sign up for an Transifex account and request the
15
addition of a new translation team for the aurweb project. Also, please do not
16
translate if you are unwilling to maintain or find someone to maintain the
17
translation. This is due to the fact that aurweb is a rapidly evolving project
18
19
20
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
21

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

24
$ git clone https://gitlab.archlinux.org/archlinux/aurweb.git aurweb-git
Loui Chang's avatar
Loui Chang committed
25

26
27
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
28

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

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

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

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

42
43
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
44
45
46


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

49
50
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
51

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

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

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

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

61
$ tx push -r aurweb.aurwebpot -t -l <locale>