JES5 Language Localize Problem in Web Interface

Question

I hope this is the correct forum to ask this question...
Here's the problem:
I wanted to make a Dutch version of the Sun Java Communication Express, so I followed all the steps you have to do (create folders, translate all the necessary files, edit .properties files, ... etc). I've also restarted the server after uploading.
It seems that everything has worked out well, because when I go to my web interface, I can log in. I change the language to Dutch, and logged out.
Now here's the weird part. When I log in again now, my "Mail" tab stays in English. But when i go to "Calendar", "Options", etc. the interface is show in dutch, as i translated them.
I've found out that the redirecting url might be wrong, cause the url that show in my browser is: (ip)/uwc/webmail/en/mail.html?lang=en&laurel=on&cal=1
It doesn't seem normal to me that, in the url, there is still "en" instead of "nl" for dutch. When I change the url manually, that's the only way to show the dutch version of my mail tab.
So propably the problem is that the url ist being editted after choosing dutch as language(when I choose French, it DOES edit the url to "fr").
Has anyone got an idea how to fix this?
Kind regards,
Andrew

Answer 1

Shane,
as I have been updating our own documentation I have also honored your request to update the publically available [ http://msg.wikidoc.info/index.php?title=Add_New_Language_ME Messaging Server wiki].
For future reference the above link may be more up-to-date then this text.
How do I add a new language to the Messenger Express interface that is not one of the languages localized by Sun?
Because Sun does not provide additional localizations beyond those already supplied, you need to do your own translation.
Start by copying the original files of one of the supported languages to the new language you need to support. In this case I translate from English (language code: en) to Dutch (language code: nl).
Your Messenger Express may be installed in a different directory, change paths accordingly.
<tt>
cp -r /opt/SUNWmsgsr/config/html/en /opt/SUNWmsgsr/config/html/nl
</tt>
Translate the file <tt>/opt/SUNWmsgsr/config/html/nl/i18n.js</tt>. It contains most of natural language used in webmail. The files <tt>help.htm</tt> and <tt>help2.htm</tt> contain a lot of help text. I cheated and replaced those files with less extensive useage instructions or just leave the original english and hope the customers don't complain too much.
For each language already supported and the new one edit the file <tt>i18n.js</tt> and add a localized name for the Dutch language and add Dutch to the supported/available languages in the options page.
<tt>
/opt/SUNWmsgsr/config/html/en/i18n.js
i18n['en']='English'
*'i18n['nl']='Dutch'*
function i18n_preferredlanguagelist()
var lang_list = new Array('en', *'nl',* 'es')
/opt/SUNWmsgsr/config/html/es/i18n.js
i18n['en']='Ingl�s'
*'i18n['nl']='Holand�s'*
function i18n_preferredlanguagelist()
var lang_list = new Array('en', *'nl',* 'es')
/opt/SUNWmsgsr/config/html/nl/i18n.js
i18n['en']='Engels'
*'i18n['nl']='Nederlands'*
function i18n_preferredlanguagelist()
var lang_list = new Array('en', *'nl',* 'es')
</tt>
The Messenger Express web interface has built in spelling check. The dictionary files come from the ancient/traditional unix ispell and are
available for download from: http://ficus-www.cs.ucla.edu/geoff/ispell-dictionaries.html
Download the Dutch affix rule file and the actual dictionary files, and use the buildhash command to make a hash file Messenger Express can use. When
copying this hash files be warned that you can't copy it from x64 to sparc (big/little endian) architectures.
<tt>wget ftp://ftp.tue.nl/pub/tex/GB95/ispell-dutch96/dutch96.lat</tt> (dictionary)
<tt>wget ftp://ftp.tue.nl/pub/tex/GB95/ispell-dutch96/dutch96.aff</tt> (affix file for use with above dictionary)
<tt>
/opt/SUNWmsgsr/lib/buildhash dutch96.lat dutch96.aff /opt/SUNWmsgsr/lib/nl.hash
</tt>
with a new dictionary in the correct place it should be detected automatically after a restart of Messenger Express.
Use configutil to make Messenger Express aware of the new language:
<tt>
/opt/SUNWmsgsr/sbin/configutil -o gen.installedlanguages
/opt/SUNWmsgsr/sbin/configutil -o local.supportedlanguages
</tt>
returns for instance the language strings: <tt>en,es</tt>. Add Dutch:
<tt>
/opt/SUNWmsgsr/sbin/configutil -o gen.installedlanguages -v "en,es,nl"
/opt/SUNWmsgsr/sbin/configutil -o local.supportedlanguages -v "[nl,en,es]"
</tt>
Make the new Dutch language the default language for this site:
<tt>
/opt/SUNWmsgsr/sbin/configutil -o gen.sitelanguage -v nl
</tt>
Restart Messenger Express (web interface) to make the changes effective.
<tt>
/opt/SUNWmsgsr/sbin/stop-msg
/opt/SUNWmsgsr/sbin/start-msg
</tt>