|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.
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:
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:
- Cyberbit Unicode Font - 7.2 megabytes
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:
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.
There are two files that the VolanoChat server administrator may need to translate:
- the VolanoChat applet property file containing its translatable user interface text. This file is found under the
vcclientsubdirectory by default.
- the VolanoChat server file containing the list of permanent room names. This file is found under the
confdirectory 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
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.
For more information about Java, fonts, and internationalization in general, please see the following pages:
|XHTML 1.0||Table of Contents|