This page is under development, proof reading needed.

1. Install needed software
2. Clone a copy from git
3. (if needed) Add your language and create the initial language file
4. Translate
5. Prepare the patch and send it to the mailing list

X2Go uses Qt4 which has a great tool to help you translate X2Go into your language - Qt Linguist.

1. To be able to translate you need to install Qt Linguist (version 4.x) - for Debian and Ubuntu you can install qt4-dev-tools, which also will install qt4-linguist-tools that also is needed. The preferred way of sending in translations is as git-patches, so we need git which in Debian and Ubuntu is accomplish with installing the package git.
2. We need a directory to keep the cloned copies of the git repository, I prefer to have mine in ~/git/ , but you can choose what suits you best.
   1. Follow the instructions on cloning a git repository from here: http://wiki.x2go.org/wiki:development:git
   2. Also remember to follow the instructions there on how to set your name and email in git
   3. When you got the git cloned locally, cd into the clone directory
3. Edit the .pro file, e.g. 'x2goclient.pro' for the x2goclient repository and add your language file there (if it doesn't exist). For Norwegian Bokmal I added this line:

   TRANSLATIONS += x2goclient_nb.ts

   Some locales have both language and territory specified, e g the file for swedish languague in Sweden is named x2goclient_sv_se.ts.

4. After adding the intended language we need to get the actual language file created. Run this in the same directory:

   lupdate <filename>.pro

   (e.g. lupdate x2goclient.pro)

5. Start Qt Linguist and open your translation file. Remember to go to Edit → Translation File Settings and set the correct target language. Save and close the Qt Linguist.

- If you want to verify your translation, you have to build the client with the new/updated language file, here's a brief instruction on how to do it on Debian:

1. Install build dependencies

   sudo apt-get install libldap2-dev libssh-dev libcups2-dev

2. In QT Linguist (with the translation file open), choose File → Release. A file named x2goclient_<language/territory>.qm is created in the same directory as the x2goclient_<language/territory>.ts file.
3. Open resources.rcc and add the qm file.
4. Configure the build:

   ./config_linux.sh

5. Build x2goclient:

   make

6. If everything works out you have a new binary to test:

   ./x2goclient

7. When you have verified that the language file is correct, move on to adding it to git (below).
8. Back in the terminal again we need to tell git about the new file we added (your language file, technically it was created with the lupdate process):

   git add <your-new-and/or-changed-files.ts>

9. Then we need to commit our changes to our local clone of the git repository:

   git commit -m "change-comment" <filename, e g x2goclient_nb.ts>

10. The last part is to create the actual patch:

    git format-patch -1

11. You should then have a newly created patch-file in your current directory which you now should attach to a mail you send to x2go-i18n@lists.berlios.de.

For more information related to git, look here: http://git-scm.com/