International Readme for the eSuite DevPack Preview

This section provides information specific to the non-English versions of the eSuite DevPack Preview release. The information is divided into the following sub-sections:

Section 1: Certified Server and Client Platforms
Section 2: Installing DevPack
Section 3: Setting Languages and Locales
Section 4: Known Problems


SECTION 1: Certified Server and Client Platforms

The certified platforms and browsers for the non-English versions of eSuite DevPack Preview are:

Servers:

Clients:


SECTION 2: Installing eSuite DevPack

The section covers the following:

Installing DevPack on your server
Installing additional JDK fonts

Installing eSuite DevPack on your servers

Both the core DevPack and the specific language pack for languages other than English must be downloaded from the Lotus eSuite Website. First download and unzip the English language program files. Then download and unzip any additional language files you want. If you download the self-extracting .EXE program (eSuiteDPP.exe) file, program files are automatically extracted to the appropriate directories. If you download the .ZIP file, you must manually unzip the files.

Resources for languages other than English are contained in separate .ZIP files. To install additional language resources you need to:

  1. Download the .ZIP file containing the appropriate language resources for each language you want.
  2. Unzip the lanugage resources into a temporary directory. This creates a set of zipped resource files for each eSuite applet archive (.JAR or .CAB).
  3. Extract each zipped set of files to the eSuiteDPP directory created when you downloaded the English language version, preserving the directory structure contained in the language resource zip file.

Notes: The language and country codes conform to the JDK standard. The instructions above assume that you have already setup IISI or Domino servers.

Installing Additional JDK Fonts

Some browsers may not properly display or enable entry of certain language characters. These problems may be alleviated by adding Unicode fonts and/or modifying the font.properties files associated with your browser's Java Virtual Machine. Microsoft Internet Explorer 4.01 generally provides adequate font handling without making any changes to your installed fonts or font.properties files. Netscape 4.04 has been found to have font problems with non-Latin language character sets such as Cyrillic, Greek, Thai or Turkish, and may require additional setup steps in order to display and enter this type of text.
Note: Font handling modifications must be made for each client workstation - modifying server settings will have no effect on individual clients. You can see a general discussion about modifying Javasoft font properties at the Javasoft web page.
To install Unicode fonts on Win95 or WinNT 4.0 systems complete the following steps:
  1. Download and run the self-extracting executable file ORIGINAL.EXE from the Bitstream home page.
  2. Open the Windows Control Panel and install the font by File\Install New Font...
  3. Backup and then modify your local font.properties file based on the information provided at the Javasoft font properties Web page. Refer to browser documentation for specific configuration instructions.

Note: The Cyberbit font is not recommended for Asian languages since it can only handle one language at a time. It is recommended that you use native (Windows) fonts for Asian languages. For a detailed discussion of Netscape 4.04 font issues please refer to the Netscape 4.04 font discussion at this Netscape Web page.
If the recommendations in the Netscape font discussion page do not remedy your font problems, an unsupported patch procedure may help. Although Lotus does not recommend this procedure, it has been found to be helpful in fixing font handling problems. Proceed at your own risk.
To patch the Netscape font.properties file complete the following steps:
  1. Locate the \NETSCAPE\COMMUNICATOR\PROGRAM\JAVA\CLASSES\JAVA40.JAR file on your system. Make a backup of this file before proceeding.
  2. Open the JAR file using a JAR editor such as WINZIP or MOAJAR.
  3. Locate (and extract if necessary) the file font.properties file in the ZIP file, then edit (using a text editor) the contents of the file to your requirements.
  4. Save (replace) the modified font.properties file to the JAVA40.JAR file, then save (update) the JAR file. Make sure to save the file to the correct directory path.

Note: Do not add or delete any files in the JAR file. If Java applications fail to work in Netscape after the patch procedure, restore the backup copy of the JAVA40.JAR file to its original location.

SECTION 3: Setting Languages and Locales

Locale is a set of definitions about cultural and geographical regions. It includes not only languages but also time zones, date/time formats, sorting methods, currency symbols, and so on. eSuite DevPack can be controlled by locale parameters in your HTML pages. eSuite DevPack recognizes the parameters and automatically switches to your preferred version of locales. The locale parameters you can specify in HTML pages are shown in Table 1.

Table 1: HTML parameters for switching locales

name setting for format
appletLocale locale <ISO 639 two-letter lowercase language code>_<ISO 3166 two-letter uppercase country code>
userInterfaceLanguage User Interface language <ISO 639 two-letter lowercase language code>
characterEncoding charcter encoding method Java Character Set Naming Convention
userTimeZone time zone 3-letter time zone id

eSuite supports a locale switching mechanism based on JDK 1.1.x. You can set a locale from the list in Table 2. For example, if you want the applet that you are currently executing to perform sorting based on the Chinese locale, you can set the appletLocale to that of zh, it will then carry out the sorting based on China PinYin sorting. appletLocale is used in areas that are linked to functionality, for example, sorting, line breaking and word selection. userInterfaceLanguage will configure the UI that you see. For example, if this parameter is set to zh, it will display the UI in Simplified Chinese. See Table 3 for a list of valid options.

charEncoding is needed when you are attempting to convert a file from Unicode back to the specified encoding character set and vice versa. See Table 4.

userTimeZone is used to configure the particular timezone for a particular locale, see Table 5.

Here is an example of settings for WordProcessor in Korea:

<applet codebase=".." code="lotus.fc.AppletContainer" width=500 height=300 name="Container">

<param name="applet_0" value="lotus.wp.WordProcessor">

<param name="name_0" value="wp">

<param name="wp.userInterfaceLanguage" value="ko">

<param name="wp.appletLocale" value="ko_KR">

<param name="wp.characterEncoding" value="KSC5601">

<param name="wp.userTimeZone" value="JST">

...

Table 2: Valid "appletLocale" Argument Literals for the eSuite DevPack Preview

    Country(Language)
    Locale Literal
    Country(Language)
    Locale Literal
    Albania (Albanian)
    sq_AL
    Latvia (Latvian)
    lv_LV
    Austria (German)
    de_AT
    Lithuania (Lithuanian)
    lt_LT
    Belgium (Dutch)
    nl_BE
    Macedonia (Macedonian)
    mk_MK
    Belgium (French)
    fr_BE
    Netherlands (Dutch)
    nl_NL
    Belorussia (Belorussian)
    be_BY
    Norway (Norwegian (Bokmoel))
    no_NO_B
    Brazil (Portuguese)
    pt_BR
    Poland (Polish)
    pl_PL
    Bulgaria (Bulgarian)
    bg_BG
    Portugal (Portuguese)
    pt_PT
    Canada (English)
    en_CA
    ROC (Chinese)
    zh_TW
    Canada (French)
    fr_CA
    Romania (Romanian)
    ro_RO
    Catalan (Spain)
    ca_ES
    Russia (Russian)
    ru_RU
    China (Chinese)
    zh_CN
    Serbia (Serbian (Cyrillic))
    sr_YU
    Croatia (Croatian)
    hr_HR
    Serbia (Serbian (Latin))
    sh_YU
    Czech Republic (Czech)
    cs_CZ
    Slovakia (Slovakian)
    sk_SK
    Denmark (Danish)
    da_DK
    Slovenia (Slovene)
    sl_SI
    Egypt (Arabic)
    ar_EG
    Spain (Spanish)
    es_ES
    Estonia (Estonian)
    et_EE
    Sweden (Swedish)
    sv_SE
    Finland (Finnish)
    fi_FI
    Switzerland (German)
    de_CH
    France (French)
    fr_FR
    Switzerland (French)
    fr_CH
    Germany (German)
    de_DE
    Switzerland (Italian)
    it_CH
    Greece (Greek)
    el_GR
    Thailand (Thai)
    th_TH
    Hong Kong (Chinese)
    zh_HK
    Turkey (Turkish)
    tr_TR
    Hungarian (Hungary)
    hu_HU
    Ukraine (Ukrainian)
    uk_UA
    Iceland (Icelandic)
    is_IS
    United Kingdom (English)
    en_GB
    Ireland (English)
    en_IE
    United States (English)
    en_US
    Israel (Hebrew)
    iw_HE
    Vietnam(Viet)
    vi_VN
    Italy (Italian)
    it_IT
   
    Japan (Japanese)
    ja_JP
   
    Korea (Korean)
    ko_KR
   

Table 3: Valid "userInterfaceLanguage" Argument Literalsfor the eSuite DevPack Preview

    JDK 1.1.3 Language
    ISO Lang
Language Support
    Albanian
    sq
language enabled
    Arabic
    ar
no support
    Belorussian
    be
language enabled
    Bulgarian
    bg
language enabled
    Chinese(Traditional)
    zh_TW
translated ui
    Chinese(Simplified)
    zh_CN
translated ui
    Croatian
    hr
language enabled
    Czech
    cs
translated ui
    Danish
    da
translated ui
    Dutch
    nl
translated ui
    English
    en
translated ui
    Estonian
    et
language enabled
    Finnish
    fi
translated ui
    French
    fr
translated ui
    German
    de
translated ui
    Greek
    el
translated ui
    Hebrew
    iw
no support
    Hungary
    hu
translated ui
    Icelandic
    is
no support
    Italian
    it
translated ui
    Japanese
    ja
translated ui
    Korean
    ko
translated ui
    Latvian
    lv
language enabled
    Lithuanian
    lt
language enabled
    Macedonian
    mk
language enabled
    Norwegian (Bokmoel)
    no
translated ui
    Polish
    pl
translated ui
    Portuguese
    pt
translated ui
    Romanian
    ro
language enabled
    Russian
    ru
translated ui
    Serbian (Cyrillic)
    sr
language enabled
    Serbian (Latin)
    sh
language enabled
    Slovakian
    sk
language enabled
    Slovene
    sl
language enabled
    Catalan
    ca
language enabled
    Spanish
    es
translated ui
    Swedish
    sv
translated ui
    Thai
    th
translated ui
    Turkish
    tr
translated ui
    Ukrainian
    uk
language enabled
     
     
 

Table 4: "characterEncoding" Argument Literals for the eSuite DevPack Preview

eSuite DevPack applets allow a user to specify a character encoding standard that best suits their language platform environment. Please use exact case and literal value when specifying the argument literal.

In the table below the "X" means that a module exists and can be loaded into memory without error. If you experience problems with character support, please contact the vendor of your browser client for support. See the JavaSoft documentation for more information.
 

characterEncoding

JDK 1.1.3.

Internet Explorer 4.01

Netscape Navigator 4.04 (patched)

8859_1

X

X

X

8859_2

X

 

X

8859_3

X

 

X

8859_4

X

 

X

8859_5

X

 

X

8859_6

X

 

X

8859_7

X

 

X

8859_8

X

 

X

8859_9

X

 

X

Big5

X

X

X

CNS11643

X

 

X

Cp037

X

  

Cp1006

X

  

Cp1025

X

  

Cp1026

X

  

Cp1046

X

  

Cp1097

X

  

Cp1098

X

  

Cp1112

X

  

Cp1122

X

  

Cp1123

X

  

Cp1124

X

  

Cp1113

    

Cp1114

    

Cp1250

X

X

X

Cp1251

X

X

X

Cp1252

X

X

X

Cp1253

X

X

X

Cp1254

X

X

 

Cp1255

X

X

 

Cp1256

X

X

 

Cp1257

X

X

 

Cp1258

X

X

 

Cp1381

X

   

Cp1383

X

   

Cp273

X

   

Cp277

X

   

Cp278

X

   

Cp280

X

   

Cp284

X

   

Cp285

X

   

Cp297

X

   

Cp33722

X

   

Cp420

X

   

Cp424

X

   

Cp437

X

   

Cp500

X

   

Cp737

X

   

Cp775

X

   

Cp838

X

   

Cp850

X

   

Cp852

X

   

Cp855

X

   

Cp856

X

   

Cp857

X

   

Cp858

     

Cp860

X

   

Cp861

X

   

Cp862

X

   

Cp863

X

   

Cp864

X

   

Cp865

X

   

Cp866

X

   

Cp868

X

   

Cp869

X

   

Cp870

X

   

Cp871

X

   

Cp874

X

   

Cp875

X

   

Cp918

X

   

Cp921

X

   

Cp922

X

   

Cp930

X

   

Cp933

X

   

Cp935

X

   

Cp937

X

   

Cp939

X

   

Cp942

X

   

Cp948

X

   

Cp949

X

   

Cp950

X

   

Cp964

X

   

Cp970

X

   

DBCS_ASCII

     

DBCS_EBCDIC

     

Default

X

X

X

EUC

     

EUCJIS

X

 

X

GB2312

X

X

X

GBK

 

   

ISO2022

 

   

ISO2022CN_CNS

   

ISO2022CN_GB

 

   

ISO2022KR

 

   

JIS

X

X

X

JIS0208

     

KOI8_R

   

X

KSC5601

X

X

X

MacArabic

X

   

MacCentralEurope

X

 

X

MacCroatian

X

   

MacCyrillic

X

 

X

MacDingbat

X

 

X

MacGreek

X

 

X

MacHebrew

X

   

MacIceland

X

   

MacRoman

X

 

X

MacRomania

X

   

MacSymbol

X

 

X

MacThai

X

   

MacTurkish

X

   

MacUkraine

X

   

MS874

X

   

SJIS

X

X

X

Unicode

X

 

X

UnicodeBig

X

 

X

UnicodeBigUnmarked

 

   

UnicodeLittle

X

 

X

UnicodeLittleUnmarked

 

   

UTF8

X

X

X

Windows-874

X

   

Extending Character Set Support in IE 4.01 and Netscape 4.04

By performing the following patch procedures, IE 4.01 and Netscape Navigator 4.04 decoding/encoding support may be extended to the level provided by JDK 1.1.x.

Files Required
ByteToCharXXXXX.class; CharToByteXXXXX.class where XXXXX represents characterEncoding (see Table 4). (ie. ByteToCharCp1251.class and CharToByteCp1251.class.)

Where to Get the Decode/Encode Class Files
Download and install Sun's JRE 1.1 (make sure it's the larger international "i" version) from the following Website: http://java.sun.com/products/jdk/1.1/jre/index.html.

Using WinZip or similar utility, locate the required class files in the \JavaSoft\Jre\1.1\lib\i18n.jar file, and extract them to a temporary directory on your hard disk.

Patching Internet Explorer 4.01
Copy the required class files into <windows>\java\lib, preserving the sun/io directory structure Please note that Java is case sensitive with respect to directory and file names.

Example:

<windows>\java\lib\sun\io\ByteToCharCp1251.class

and

<windows>\java\lib\sun\io\CharToByteCp1251.class

Patching Netscape 4.04 (JDK 1.1.4 update)
Copy the required class files into Netscape\Communicator\Program\Java\Classes, preserving the sun/io directory structure. Please note that Java is case sensitive with respect to directory and file names.

Example:

Netscape\Communicator\Program\Java\Classes\sun\io\ByteToCharCp1251.class

and

Netscape\Communicator\Program\Java\Classes\sun\io\ByteToCharCp1251.class

Table 5: Valid "userTimeZone" Argument Literals for the eSuite DevPack Preview

GMT ECT EET ART EAT
MET NET PLT IST BST
VST CCT JST ACT AET
SST NST MIT HST AST
PST PNT MST CST EST
IET PRT CNT AGT BET


SECTION 4: Known Problems

All Languages

Currency symbols which are not supported by the font will be displayed incorrectly.

In the Sheet Applet, @functions with multiple numeric arguments will save to file as the calculated value. This problem occurs in languages which use a comma as numeric separator symbol.

User Assistance (Help) is untranslated and remains in the original English.

The Bean properties, "userInterfaceLanguage" and "appletLocale", are not fully functional.

Asian Languages:

In the Graphics Applet, an image with a DBCS file name will not link into a Graphics page.

In the Sheet Applet, the a range name will not create unless you input range name, type address for the range, then click define button.

Korean

In the Sheet Applet, Korean characters are sorted by Unicode values.

In the Sheet Applet, Hanguel /Hanja conversion doesn't work for an already composed character on IE4.01.

Thai

Typing sequence of Thai characters and Thai cursor movement are not implemented for DevPack Preview.

Thai characters do not display correctly in IE4.01 unless user changes fonts to Dialog/DialogInput font in data input areas.

The Thai DevPack Preview project scheduler applet is untranslated and remains in the original English.

Czech, Greek, Hungarian, Polish, Russian, Turkish

The DevPac preview WK1 file format does not support these language character sets.

Turkish

In the Sheet Applet, Turkish Lira currency symbol is not supported.