|
|
Table of Contents |
The VolanoChat product contains translations of the user interface text for English, French, German, Italian, Portuguese, 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 the Properties section of the VolanoChat Applet chapter.
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.
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 10.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 appear at all, show up as boxes () or show up 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:
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.
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 10.1 above.
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.
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:
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 10.1 above.
There are two files that the VolanoChat server administrator may need to translate:
english.txt
vcclient
subdirectory by default.
rooms.txt
vchat2.1.x 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 out 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
vchat2.1.x directory. For example, on an American English
Windows NT system the file contains:
server.version = Version 2.1.x server.properties = C:\vchat2.1.x\properties.txt server.license = VolanoChatPro - 5 connection limit server.expiration = null server.host = red (192.168.0.2) server.port = 8000 java.vendor = Sun Microsystems Inc. java.vendor.url = http://www.sun.com/ java.version = 1.1.7 java.class.version = 45.3 java.compiler = symcjit os.name = Windows NT os.version = 4.0 os.arch = x86 user.language = en user.region = US 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:
|
|
Check HTML | Table of Contents |