developing for a world wide audience

WORLDWARECONFERENCE

Developing for a World-Wide Audience

Michael LabriolaSenior ConsultantDigital Primates

Page 0 of 59

WORLDWARECONFERENCE

Who am I?

Michael LabriolaSenior ConsultantDigital Primates

• Client side architect specializing in Adobe Flex– Designed and implemented UCA and CLDR implementation for

ActionScript– Lead architect and developer of FlexUnit 4

• Team Mentor• Individual Member of the Unicode Consortium• Architected applications deployed worldwide

of 59

WORLDWARECONFERENCE

What are we going to cover?

The challenges of internationalizing and localizing an application

A general strategy for keeping some of these challenges in check by using a well-defined presentation tier

of 59

WORLDWARECONFERENCE

Terminology

As with every technical debate, at some point the definition of the words internationalization(i18n) and localization(L10n) will be called into question.

Here are the definitions I choose to use for this presentation:

of 59

WORLDWARECONFERENCE

Terminology

i18n – designing and developing a product to be easily adaptable to a multitude of cultures, languages and locations

L10n – Adapting that product to meet the needs to a specific market

of 59

WORLDWARECONFERENCE

Challenges of global applications

Internationalization is not free.

It is usually not cheap.

Regardless of the platform you choose for development, it is never completely automatic

of 59

WORLDWARECONFERENCE


Internationalization is a process and even more so an awareness that must be continually evaluated throughout development

It is made easier when considered from the beginning and disproportionately more difficult when it is an after thought

of 59

WORLDWARECONFERENCE


International support is a business decision

The goal of internationalizing a product is to reach new markets

The ultimate goal is to ensure that the decision to pursue new markets is a business, not a technical, choice

of 59

WORLDWARECONFERENCE


The decision to internationalize is a big deal

It means a bigger budget, new requirements and longer development and QA cycles

Why do it? Ideally to sell the same software the a new marketplace. To achieve a bigger ROI on software.

of 59

WORLDWARECONFERENCE


Internationalization is not an all or nothing decision.

There are decisions as to the amount of support

The more support, the more cost, the more opportunity to reach new markets.

of 59

WORLDWARECONFERENCE

Visibility of Efforts

of 59

WORLDWARECONFERENCE

Externalizing Content

Externalizing content is a highly visible step. It involves removing all hard coded labels and messages

While visible, only performing this step will mean that you can support different locales speaking the same language reasonably well. You can likely support some additional locales poorly.

WORLDWARECONFERENCE

Challenges: Externalizing

Externalizing content means that nothing displayed to the user can be hard-coded in your application

LabelsUser MessagesError MessagesReference DataDate and Time FormatsImages

of 59

WORLDWARECONFERENCE


All external content must be defined in some external source such as a property file, XML document or even database

All code must respect variability. You cannot have code such as:

if ( selectedItem == "Male" ) {

}

of 59

WORLDWARECONFERENCE


Further, when parsing user input, you cannot assume currency symbols, placement of text punctuation, decimal or thousands separators or order of elements.

1,000.24 or 1.000,24

Output display and input parsing need to work together else you are displaying one format to a user and asking them to enter data in another.

of 59

WORLDWARECONFERENCE

Using Unicode

Unicode maps every viable character to a unique code point, allowing you access to a multitude of written languages

CLDR - Unicode Common Locale Data Repository provides locale specific data which explains how to use and format data for a given locale.

of 59

WORLDWARECONFERENCE

Challenges: Unicode

There are various levels of Unicode support in different runtimes, development languages and tools

Internally storing strings for display and user input as Unicode code points is a great step forward, however, care still needs to be taken whenever searching, comparing or manipulating strings.

Don’t forget where you store the strings

of 59

WORLDWARECONFERENCE

Challenges: Unicode

Comparing strings in the world of Unicode is not quite the simple == operation many of us are used to.

Standard string comparison functions built into languages may or may not work for this purpose

Worse yet, they may appear to work in your locale and only break with others.

Does ( a == á ), ( e-mail == email == Email )

of 59

WORLDWARECONFERENCE

Challenges: Unicode

By way of example, different operating systems, browser versions and runtimes have different Unicode support.

Most versions store strings as UTF-8 or UTF-16 internally, however, support for characters outside of the Basic Multilingual Plane (BMP) is trickier and not as intuitive

of 59

WORLDWARECONFERENCE

Challenges: Unicode

Further, remember that there is no such thing as a universal sort

Unicode helps us to define common characters. However, those characters are used in different locales in different ways.

The same physical character often sorts in a different order in neighboring locales. Ö != Ö

of 59

WORLDWARECONFERENCE

Challenges: Unicode

Do not assume that your development tools, language, etc. understands and handles this sorting properly

Before version 10.1 of the Flash runtime, and SilverLight 4, it was necessary to use 3rd party tools to accomplish some of these tasks correctly

of 59

WORLDWARECONFERENCE

Dynamic Sizing and Placement

How much space content should take and where it should be placed on the screen is defined by language, locale and font

It is unlikely that a translated message to another language will ever take the exact same amount of screen space. Some locales will expect form headings and scroll bars to be in drastically different places.

of 59

WORLDWARECONFERENCE

Challenges: Sizing and Placement

Therefore, you can never assume an absolute font size. Some glyphs cannot be accurately displayed below approximately a 12pt font

You can also never assume that two strings will concatenate in the same way in different languages.

Care must be taken with text inputs embedded in a string

of 59

WORLDWARECONFERENCE


As noted, strings represented in different languages and different fonts take different amounts of space to display

Not only can you not assume the size of a field, you must also not assume absolute positioning of other fields

Sizing and placement must be handled fluidly

of 59

WORLDWARECONFERENCE


Screen shot of app with fixed size

of 59

WORLDWARECONFERENCE


Dynamic sizes but not dynamically positioned

of 59

WORLDWARECONFERENCE


Resized and repositioned

of 59

WORLDWARECONFERENCE

Customizing ViewsCustomizing views per

locale is the ultimate expression of localization

How do you manage to have customized views per locale and not allow it to become a nightmare of custom builds and custom code?

of 59

WORLDWARECONFERENCE

Solutions

So, how do you define an effective client side architecture for i18n and L10n application?

You need to start by separating meaning from display

For example, Unicode maps characters. It allows others to decide how those might appear on the screen

of 59

WORLDWARECONFERENCE

Number

1 is a number, it represents a count of some abstract item. We can represent it a variety of ways but it has a known meaning:– 1– 1.0– 1,0– 1.00000000– One– Uno

of 59

WORLDWARECONFERENCE

Numbers

Similarly 3 quarters of a whole has a meaning, regardless of presentation:– .75– ¾– 0,75

of 59

WORLDWARECONFERENCE

Dates

Dates also represent a point in time relative to another point in the past. While the choice of fixed point may vary from culture to culture the meaning of a date is the same:

– 03/14/2010– 14/03/2010– The fourteenth of March, year Two Thousand and Ten

Anno Domini – 29, Rabi' al-awwal ( األول 1431 (ربيع

of 59

WORLDWARECONFERENCE

Reference Data

Even non-simple types share the same trait. For example, the biological sex of an individual has a specific meaning which is conveyed regardless of the word used to describe it

– Male or Female– M or F– Macho o Hembra

of 59

WORLDWARECONFERENCE

Meaning

In all cases there is an underlying meaning which is being shown in one of a variety of ways

Understanding the meaning of data separate from the way it is shown or the way it is entered is a major part of the solution for client internationalization problems

of 59

WORLDWARECONFERENCE

Meaning

In other words, we need to separate the idea of presenting the data from the meaning

This fits inline with the idea of a multi tiered approach to client-server architecture

..which fits in very well with my talk.

of 59

WORLDWARECONFERENCE

Tiers

of 59

WORLDWARECONFERENCE

Solving the problem

The major focus of our i18n work is the presentation tier.

Storing and saving data with meaning in mind, and never with format

Relying on the presentation tier to format and interpret incoming format into raw data.

of 59

WORLDWARECONFERENCE

Why?

Well, let’s consider the alternative• Does it make sense at the data level?

– Once data is stored with format it becomes a constant struggle to interpret it for different locales. However, your data layer needs to be capable of storing i18n info.

• Does it make sense at the logical level?– The logical level should do operations on data. To me it

is very important that the data is already normalized before the logical layer touches it. The biggest challenge is not messing it up here.

of 59

WORLDWARECONFERENCE

Example Solutions

These examples are Flex-based, however, the concepts are not Flex-specific.

The concepts, not the language or implementation are important here

of 59

WORLDWARECONFERENCE

Adobe Flex Primer

Adobe Flex is a technology designed to build the presentation tier of rich Internet applications.

These applications resemble client server applications more than web applications

They are executed in a virtual machine on the client.

of 59

WORLDWARECONFERENCE

RIA

RIAs continue to advocate separation of view from data.

This concept make RIAs extremely practical for our purposes

A developer can create a view which automatically monitors and reacts to changes in an underlying data model.

Page 45 of 59

WORLDWARECONFERENCE

Data / View Interaction

That means that, in general, a developer interacts with data.

The view of that data is represented by one or more classes and can vary without changing the underlying logic.

Page 46 of 59

WORLDWARECONFERENCE

Form v Function

It is viable to say that, when coded in this manner, the concepts of form and function are decoupled.

You can define the functionality of a component or view. That functionality can remain in tact regardless of how you choose to display it on the screen.

Page 47 of 59

WORLDWARECONFERENCE

Getting to Meaning

So, why does this make sense for an i18n application?

Because developers can interact with meaning. The formatting of that meaning becomes part of the view.

As the form and function are separate, you can have multiple, very distinct views of the same data without rewriting the functionality in any way

Page 48 of 59

WORLDWARECONFERENCE

Examples

Let’s take a look at some of the specific tools available to the Flex developer which aid in this goal

Page 49 of 59

WORLDWARECONFERENCE

Data Binding

Data Binding is a key concept where the view monitors data for changes.

When a chance occurs, the view updates as in this simple Currency example

Page 50 of 59

WORLDWARECONFERENCE

AutoLayout

The ability to auto size and auto layout content are huge advantages when considering i18n.

This is a very quick example of dynamic layout

Page 51 of 59

WORLDWARECONFERENCE

External Resource Files

Most modern frameworks allow you to define your externalized strings in property or resource files.

Those files can be added to a project at compile time or loaded at runtime as needed

Page 52 of 59

WORLDWARECONFERENCE

View Skinning

View Skinning is the first place that one can truly begin to understand the message of form and function separation

When skinning a component or view it is possible to completely change anything visual about the component without ever changing the functionality

Page 58 of 59

WORLDWARECONFERENCE

Contact Information

Michael Labriolahttp://twitter.com/mlabriola

Page 59 of 59

developing for a world wide audience

Documents

unicode unicode

strings page

email page

worldwide page

intuitive page

choice page

automatic page

different unicode support