Translation Tutorial

This tutorial is for HyperVM and Kloxo as they use the same code and files for translations.

Check first at http://project.lxcenter.org/ project Languages to see if not already someone has or is busy to translate the same language as you want.
Make an account at the project website if you do not already have one and create a new issue which language and what product you going to work on.

Log in to to your system shell and go to:

• # cd /usr/local/lxlabs/[PRODUCTNAME]/httpdocs/lang/ (where productname is hypervm or kloxo)

There you see some dirs with country letters.
Copy the en dir to your country letter code:

• # mkdir nl (to create a nl translation dir)
• # cp en/* nl/ (to copy en files to nl translation dir)
• # cd nl
• # ls -l

Dir content

-rw-r--r-- 1 root root 5 Jul 14 21:54 charset
-rw-r--r-- 1 root root 61652 Jul 14 21:54 desclib.php
-rw-r--r-- 1 root root 710 Jul 14 21:54 langfunctionlib.php
-rw-r--r-- 1 root root 2095 Jul 14 21:54 langkeywordlib.php
-rw-r--r-- 1 root root 32183 Jul 14 21:54 messagelib.php

charset: Optional file, use if your translation set does need a charset setting (For example put a line in the file: UTF-8)
desclib.php: To define Descriptions
langfunctionlib.php: To define Plurals (Need a little bit PHP expirence to understand)
langkeywordlib.php: To define Keywords
messagelib.php: To define Messages

You can translate now.

Create a zip file from the files you have translated and attach it as file to the issue at the project website.


Log-in as root and run the following (example for the greek language):

cd /usr/local/lxlabs/[PRODUCTNAME]/httpdocs/
lphp.exe ../bin/common/langcompare.phps en gr

It will print the untranslated strings to standard output.

If you are familar with SVN checkouts/commits, you can checkout the i8nl tree.

• svn co http://svn.lxcenter.org/svn/i8nl

If you need a translator access account to commit your files, please fill in the apply at http://svn.lxcenter.org/ and mention that you are a translator.

---