Previous Next Up FAQ Table of Contents

8.1 Translating VolanoChat

The VolanoChat product contains translations of the user interface text for English, French, German, Italian, Portuguese, Dutch, and Spanish. To translate the VolanoChat applet user interface text into other Western languages, simply edit one of the applet property files to create your own new translation. The VolanoChat applet property files are described in [7.1.2] VolanoChat Properties.

This page describes the additional steps that may be required in order to translate the VolanoChat user interface text into non-Western languages such as Hebrew, Arabic, Chinese, Japanese, and Korean.

Web browser support

Before testing your translation of the VolanoChat applet, you should verify that your browser has support in Java for a full Unicode font or at least for a font containing your own local character set. The Java applet below shows characters on the right taken from the language or alphabet name listed to their left.

Applet 1: Sample Unicode characters.

If you see characters correctly representing the required language or alphabet, your browser is already configured to support the translation. If some of the required characters do not display at all, display as boxes () or appear as question marks (??????????), you will need to upgrade to the latest Web browser support as described below.

Netscape Communicator

In order to view non-Western characters correctly from within Java applets in Netscape Communicator, you need to run Version 4.06 or later. To install the correct support, follow the steps below:

Step 1. Upgrade to the latest version of Netscape

If you are running an earlier version of Netscape Communicator, download and install Version 4.06 or later from Netscape's Free Software Upgrade page by clicking the following button:

Download Netscape Now!

After upgrading to Version 4.06 or later, check the applet at the top of this page to see whether you can view the characters correctly. If not, you can continue with the following step.

Step 2. Install a Unicode font

If you want to be able to see any characters in Java applets (not just the characters of your local region and language), download and install a Unicode font. For Western versions of Windows 95, 98, and NT 4.0, a Unicode font by Bitstream is available for free from:

Run the original.exe program to unpack the archive. Open the Fonts folder of the Windows Control Panel and select File, Install New Font.... Find the folder where you unpacked the archive, select the font called "Bitstream Cyberbit (True Type)", and press the OK button. Then close and relaunch your Netscape Web browser.

After upgrading to the latest version of Netscape and installing a Unicode font, you should be able to see all of the characters in Applet 1 above.

Microsoft Internet Explorer

Although Microsoft Internet Explorer does not support Unicode fonts in 100% Pure Java™ applets like VolanoChat, you should have no trouble viewing the characters of your local region and language when using VolanoChat. In other words, if you have an American English version of Windows 95, you probably won't be able to see Japanese characters represented correctly in applets running under Internet Explorer, but a Japanese version of Windows 95 will see them just fine.

Step 1. Upgrade to the latest version of Internet Explorer

In any case, for the best results you'll still need the latest version of Internet Explorer. You can get the latest version from the Microsoft Internet Explorer Products Download page by clicking the following button:

Get Microsoft Internet Explorer

Step 2. Install international language support

You can download support for other languages and character sets by selecting and installing the international language support from this page:

After upgrading to the latest version of Internet Explorer and installing the international language support packages, you should be able to see all but the last two sets of characters (Katakana and CJK) in Applet 1 above.

VolanoChat support

There are two files that the VolanoChat server administrator may need to translate:

english.txt
the VolanoChat applet property file containing its translatable user interface text. This file is found under the vcclient subdirectory by default.
rooms.txt
the VolanoChat server file containing the list of permanent room names. This file is found under the conf directory by default.

If you translate either of these files into a language that uses non-Western characters, you need to convert the file into an ASCII representation of its Unicode values. Fortunately, Java provides a tool to do the conversion in the 1.1 release of the Java Development Kit. The tool is called the Native-to-ASCII Converter, and you run it with the native2ascii command. The tool converts a file with native-encoded characters (characters which are not Latin 1 or Unicode) to one with Unicode-encoded characters.

For example, to convert a VolanoChat applet property file called japanese.jis, containing Japanese (EUC-JP encoded) characters, to a format understood by the VolanoChat applet, enter the command:

native2ascii -encoding EUCJIS japanese.jis japanese.txt

This command takes each character in the japanese.jis file and converts it into an ASCII representation of its Unicode value. The converted result is placed in the file japanese.txt.

To find your local file encoding, look in the support log file generated when you start the VolanoChat server. By default the file is called support.log and is located in the /conf subdirectory of your VolanoChat installation.. For example, on an American English Windows NT system the file contains:

server.version     = Version 2.6.1
server.properties  = C:\Documents and Settings\volano\vchat2.6.1\conf\properties.txt
server.license     = VolanoChatPro - 5 connection limit
server.expiration  = Wed Mar 03 00:00:00 PST 2004
server.host        = guest (192.168.0.3)
server.port        = 8000
java.vendor        = Sun Microsystems Inc.
java.vendor.url    = http://java.sun.com/
java.version       = 1.4.2_03
java.class.version = 48.0
java.compiler      =
os.name            = Windows 2003
os.version         = 5.2
os.arch            = x86
user.language      = en
user.region        =
file.encoding      = Cp1252
file.encoding.pkg  = sun.io

specifying a file encoding of Cp1252. The Native-to-ASCII Converter page lists all of the file encodings supported by Java.

Once you have converted your translated files into their canonical ASCII representation, you can transfer the files to whatever machine is running your VolanoChat server, regardless of the server's native region, language, or file encoding. In this way you can have American servers providing Russian applet interfaces, or Chinese servers providing applet interfaces in Hebrew. Make sure to transfer the converted files in ASCII if you're using an FTP (File Transfer Protocol) program.

Other resources

For more information about Java, fonts, and internationalization in general, please see the following pages:


Previous Next Up FAQ XHTML 1.0 Table of Contents

2014-07-11 — An updated version of the VOLANO chat server that supports the latest Java 8 Plug-in is now available. More…

The VOLANO® chat software for the Java™ platform lets you build on-line communities and add real-time social networking to your Web site. More…

John Neffenger <john@status6.com>
More…

A PROJECT OF STATUS:6®