uPortal Internationalization Shoji Kajita Associate Professor, PhD IT Center, Nagoya University Japan Justin Tilton President Instructional Media + Magic U.S.A.

This Session’s Agenda “Overview of uPortal I18n” by Shoji Kajita Target: 2.2 Release on October, 2003 “XLIFF and uPortal” by Justin Tilton Target: Beyond 2.2 Release

Overview of uPortal I18n Shoji Kajita Associate Professor, PhD IT Center, Nagoya University Japan

Quick Poll How many languages do you want to support on your institutional portal? One Language Two Languages More than Three Languages What language do you expect to be supported by uPortal?

Agenda Goal Things To be Done By uPortal Framework Developer By XSL Files Translator By uPortal Channel Developer Short Demonstration Localized uPortal into Japanese I18ned uPortal under development

Locale A set of conventions affected or determined by human language and customs, as defined within a particular geo-political region. These conventions include (but are not necessarily limited to) the written language, formats for dates, numbers and currency, sorting orders, etc. (Frank Tang: “Mozilla I18n & L10n Guideline”)

Locale Used in uPortal Locale = “Language Code” + “Country Code” To support Celtic and Welsh, uPortal development team decided to use ISO 639-2: three letter language codes ISO 3166: three letter country codes Examples: eng_USA, eng_GBR, jpn_JPN, swe_SWE

Internationalization Frank Tang: “Mozilla I18n & L10n Guideline” Designing and developing a software product to function in multiple locales. This process involves identifying the locales that must be supported, designing features which support those locales, and writing code/transformations that functions equally well in any of the supported locales. (Frank Tang: “Mozilla I18n & L10n Guideline”)

Goal of uPortal Internationalization Locale Independent Components, Resources and Processing US English UK English Swedish Japanese Chinese 1.Separating locale dependent components, resources and processing 2.Preparing translated resources for each locale 3.Allowing users to select their locale resource

What kind of work is required to internationalize uPortal? By localizing Number Guessing Game into Japanese

Localization Number Guessing Game into Japanese CNumber Channel XML CNumber Channel XML CNumber Channel XSL Original CNumber Channel XSL Original CNumber Channel XSL Japanese CNumber Channel XSL Japanese 1 A language selection mechanism is required 2 XSLT Processor

Number Guessing Game Japanese Version The title string is saved in UP_CHANNEL table of RDBMS 4 The string “higher” is hardcoded in CNumber.java 3

uPortal I18n is Collaborative Works 1. Framework Developers 2. XSL Files Translators 3. Channel Developers

1. Things to be Done by uPortal Framework Developers (1) UTF-8 Transparency (Usually, Latin1 Transparent) RDBMS uPortal XXX: UTF-8 Characters XXX Properly saved Properly displayed “UTF-8 transparent” in uPortal2.1/2.0.3 framework

1. Things to be Done by uPortal Framework Developers (2) Locale-aware Processing Locale Selection Mechanism for Users

Users can select their desired locale by clicking the language icon

1. Things to be Done by uPortal Framework Developers (2) Locale-aware Processing Locale Selection Mechanism for Users Passing Locale[] into Channel User Preferred Locales –Browser Setting –CLocaleChooser (Locale Selection Mechanism) –Channel Dependent User Preference –External System (ex. LDAP)

Passing Locale[] into Channel public class ChannelRuntimeData … { private String Locale[]; …………….. }

1. Things to be Done by uPortal Framework Developers (2) Locale-aware Processing Locale Selection Mechanism for Users Passing Locale[] into Channel User Preferred Locales –Browser Setting –Locale Selection Mechanism –External system (ex. LDAP) Framework Supported Locales Locale-Dependent Resource Selection Mechanism

Locale-Dependent Resource Selection Mechanism (XSL Files) XSLT xslt = new XSLT(this); LocaleAwareXSLT xslt = new LocaleAwareXSLT(this, locale); xslt.setXML(doc); xslt.setXSL(sslLocation, runtimeData.getBrowserInfo()); xslt.setTarget(out); xslt.setStylesheetParameter("baseActionURL", runtimeData.getBaseActionURL()); if (!staticData.getPerson().getSecurityContext().isAuthenticated()) { xslt.setStylesheetParameter("unauthenticated", "true"); } xslt.transform(); Don’t have to change

Locale-Dependent Resource Selection Mechanism (DB Info)

2. Things to be Done by Translators XSL Files Translation into Each Language Wiki-based Translation Site XLIFF-based Translation Site (Near future)

3. Things to be Done by uPortal Channel Developers 1. UTF-8 Transparency

1. UTF-8 Transparency for Channel RDBMS XXX ??? “UTF-8 transparency” is depending on channel uPortal2.1 ??? XXX Channel ? CWebProxy:● → ● committed in CVS CBookmark: ● → ● reported in Bugzilla CWebCT: ● → ● fixed but not checked in CVS repository UBC Webmail:● → ● fixed but not checked in CVS repository CuCMS: ● done by Alex ???

CWebProxy CBookmark

CWebmail

3. Things to be Done by uPortal Channel Developers 1. UTF-8 Transparency 2. Functions to select Locale from Locale[] 3. Locale Dependent Resources XSL Files ResourceBundle to use locale-dependent resources in Java code

A Short Demonstration of Localized uPortal into Japanese

A Short Demonstration of Internationalized uPortal

We Need Volunteer! Translation of XSL files Framework Development Developer Meeting at Cornel University on August

uPortal Internationalization More than software problem Forming the uPortal International community to exchange knowledge, know-how, tools and so on among higher educational institutions in the world!

Justin’s Presentation