summaryrefslogtreecommitdiffstats
path: root/documentation/translating.txt
blob: 95aff1859a2bfd1b969aa005b5431acd3a143fe8 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
Translating
===========

This document describes how to create and maintain aurweb translations. It was
originally derived from
<https://wiki.archlinux.org/index.php/aurweb_Translation>.


Creating a New Translation
--------------------------

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


1. Check out the aurweb source using git:

  $ git clone git://projects.archlinux.org/aurweb.git aurweb-git


2. Go into the 'po/' directory in the aurweb source, and run +msginit(1)+ to
   create an initial translation file from our translation catalog:

  $ cd aurweb-git
  $ git checkout master
  $ git pull
  $ cd po
  $ msginit -l <locale> -o <locale>.po -i aur.pot


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

  $ poedit <locale>.po


4. If you have a working aurweb setup, add a line for the new translation in
   'web/lib/translator.inc.php.


5. Upload the newly created '.po' file to Tranisfex. If you don't like the web
   interface you can also use transifex-client to do that (see below).


Updating an Existing Translation
--------------------------------

1. Download current translation files from Transifex. You can also do this
   using transifex-client which is avaliable through the AUR:

  $ tx pull -a


2. Update the existing translation file using an editor or a tool like poedit:

  $ poedit po/<locale>.po


3. Push the updated translation file back to Transifex. Using transifex-client,
   this works as follows:

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


/////
vim:set ts=4 sw=4 syntax=asciidoc noet spell spelllang=en_us:
/////