Tuesday, May 22, 2007

Creating translation for dotproject

Dotproject is an open source project management system. It is built by default based in English language but whomever wants to translate it to their own native language, dotproject provide language management where the user can use other language in their dotproject. There are two ways to do this translation. First, if available, you can download the pre-translated configuration files from the internet and embed it in your dotproject system. Second, if there is no translation for your language available, you can create your own translation files and do the translation yourself. In this guide, I would like to show you how to do the translation yourself.
The steps:

  1. Create a new directory under dotproject/locales directory and name it according to your language iso code. Give appropriate permission to this folder (ex: write permission for others). The code can be found at http://ftp.ics.uci.edu/pub/ietf/http/related/iso639.txtCreate locales.php inside yor newly created folder. This is the content of the file(put it inside php tags):
$dir = basename(dirname(__FILE__));
$LANGUAGE['aa_BB'] = array($dir, 'Language Name (in English)', 'Language name (in Language)', 'xxx');

  • aa_BB is the iso 2 character language code 'aa', followed by the ISO 2 character country code 'BB' (http://www.bcpl.net/~j1m5path/isocodes.html)
  • The first instance of the language name should be in English The second should be in the native language. The last field 'xxx' is the Microsoft language code (http://msdn2.microsoft.com/en-us/library/ms533052.aspx)
Example of locales.php file for Bahasa Melayu(put it inside php tags):

$dir = basename(dirname(__FILE__));
$LANGUAGES['ms_MY'] = array($dir, 'Malay', 'Bahasa Melayu', 'msl');

2. Create file lang.php inside the newly created folder. The content of the file is similar to the locales.php

3. Log in as system admin to your dotproject system. Go to System Admin > Translation Management and choose your language from the drop down menu. Start translating. DO NOT attempt to edit the INC files directly to create your translation - it won't work.

No comments: