1Translating X2Go Client
2======================
3
4Translating with Qt-Linguist
5------------------------
6
7X2Go Client uses Quick Translation mechanism (.qm, .ts files).
8The translation files can be found in the main folder of X2Go Client of this source project.
9
10
11New team member --- new language for X2Go Client
12-----------------------------------------------
13If you are a new member in the x2go-i18n team, the first we say is: WELCOME!!! and
14THANKS!!! for the time you give to the X2Go project.
15
16And, if you are new to the team and language files for the language you want to feel
17responsible for do not yet exist, please subscribe to this mailing list first:
18
19  https://lists.x2go.org/listinfo/x2go-i18n
20
21Once you are subscribed, send an email to
22
23  x2go-i18n@lists.x2go.org
24
25that explains your willingness to translate this-and-that language.
26
27The developers will then provide a language file for you in the above mentioned /po
28folder.
29
30
31Git cloning
32-----------
33Next thing to do is to obtained the latest sources from X2Go Git.
34
35  $ # git needs to be installed, on Debian/Ubuntu this is
36  $ aptitude install git       # <----for debian
37  $ sudo apt-get install git   # <----for ubuntu
38  $ # then checkout the code
39  $ git clone git://code.x2go.org/x2goclient.git
40
41In your current working directory there should now be a subfolder named ,,x2goclient''.
42
43
44Creating Your Language File
45---------------------------
46First, copy the file x2goclient_de.ts, for instance via the terminal.
47
48You can do this by running the following commands:
49
501. cd x2goclient/res/i18n
51
522. cp x2goclient_de.ts "x2goclient_da.ts <or what language your going to translate it into>".
53
54Now, the file is ready for editing to your desired language.
55
56
57Editing Your Language File
58--------------------------
59The tool needed for editing qt translation files is ,,linguist-qt4''
60
61  $ open Ubuntu Software Center, search for ,,Qt 4 Linguist'' and install it from there  # <--for ubuntu
62
63Now open your language file in <current_dir>/x2goclient/res/i18n/x2goclient_<lang>.ts and edit it with
64linguist-qt4.
65
66NOTE: Make sure you translate all boldly marked items: non-translated as well as fuzzy
67(i.e., inaccurate) items.
68
69
70
71Sending in the Translation File
72-------------------------------
73When done, please send the complete translation file
74
75  <current_dir>/x2goclient/res/i18n/x2goclient_<lang>.ts
76
77to x2go-i18n@lists.x2go.org and remove your working copy of X2Go Client from
78your system (or read how to use Git and keep the folder.)
79
80
81Next time...
82------------
83You will get informed on x2go-i18n if a translation update is necessary. So check
84your mails there regularly.
85
86For updating a translation, keep the X2Go Client source project folder and read
87more about Git by yourself.
88
89Alternatively, just remove the folder (once you have sent in the translation file)
90and start with this documentation all over again.
91
92THANKS AGAIN FOR YOUR TIME!!!
93
94light+love,
95
96  Mike Gabriel <mike.gabriel@das-netzwerkteam.de>
97