BEA Server Locale Message Catalog Syntax

Message Catalog Formats

Internationalization Guide 2-15

Locale Message Catalog Syntax

The following example shows a French translation of a message that is available in

...\msgcat\fr\MyUtilLabels.xml.

The translated message appears as shown in Listing2-4.

Listing 2-4 Example of a Message Translated to French

<?xml version="1.0"?>

<!DOCTYPE message_catalog PUBLIC

"weblogic-locale-message-catalog-dtd"

"http://www.bea.com/servers/wls700/dtd/l10n_msgcat.dtd">

<locale_message_catalog

l10n_package="programs.utils"

subsystem="MYUTIL"

version="1.0">

<message>

<messageid="FileMenuTitle">

<messagebody> Fichier </messagebody>

</message>

</locale_message_catalog>

When entering text in the messagebody, messagedetail, cause and action

elements, you must use a tool that generates valid Unicode Transformation Format-8

(UTF-8) characters, and have appropriate keyboard mappings installed. UTF-8 is an

efficient encoding of Unicode character-strings that optimizes the encoding ASCII

characters. Message catalogs always use UTF-8 encoding. The MessageLocalizer

utility that is downloaded with WebLogic Server is a tool that can be used to generate

valid UTF-8 characters.

Contents

Main Copyright Restricted Rights Legend Trademarks or Service Marks Part Number Document Revised Software Version Contents About This Document 1. Overview of Internationalization for WebLogic Server 2. Using Message Catalogs with BEA WebLogic Server 3. Using the BEA WebLogic Server Message Editor 4. Using the BEA WebLogic Server Internationalization Utilities Page Page About This Document Audience e-docs Web Site How to Print the Document Related Information Contact Us! xInternationalization Guide Documentation Conventions The following documentation conventions are used throughout this document. Convention Usage Page Page 1 Internationalization for WebLogic Server About Internationalization and Localization Standards 1 Understanding Localization for WebLogic Server Understanding Message Catalogs Understanding Message Catalogs 1 Understanding Java Interfaces for Internationalization Main Steps for Creating an Internationalized Message Main Steps for Creating an Internationalized Message Page 2 Catalogs with BEA Overview of Message Catalogs Message Catalog Hierarchy Choosing Names for Message Catalogs Choosing Names for Message Catalogs Using Message Arguments Message Catalog Formats Elements of a Log Message Catalog 2-6 Internationalization Guide message_catalog The following table describes the attributes that you can define for the Internationalization Guide 2-7 log_message The following table describes the attributes that you can define for the log_message element. 2-8 Internationalization Guide Other log_message Catalog Elements The following table describes the child elements of the log_message element. Log Message Catalog Example 2-10 Internationalization Guide Elements of a Simple Text Message Catalog message_catalog message 2-12 Internationalization Guide messagebody The following table describes the child element of the message element. Simple Text Catalog Example Elements of a Locale-Specific Catalog locale_message_catalog log_message Other locale_message_catalog Elements Locale Message Catalog Syntax Page 3 WebLogic Server Message Editor About the Message Editor Page Starting the Message Editor Starting the Message Editor Working with Catalogs Working with Catalogs Browsing to an Existing Catalog Page Page Page Adding Messages to Catalogs Adding Messages to Catalogs Entering a New Log Message Page Adding Messages to Catalogs Entering a New Simple Text Message Finding Messages Finding a Log Message Finding Messages Finding a Simple Text Message Using the Message Viewer Viewing All Messages in a Catalog Using the Message Viewer Viewing All Messages in Several Catalogs Choosing a Message to Edit from the Message Viewer Editing an Existing Message 4 About the WebLogic Server Internationalization and Localization Interfaces About the WebLogic Server Internationalization and Localization Interfaces 18ngen Utility l10ngen Utility Internationalization Guide 4-5 l10ngen Utility where <l10n_Classpath> should include <WebLogic internationalized messages. CatInfo Utility CatInfo Utility Page A Reference for BEA About Localizer Classes A Localizer Methods Localizer Lookup Class Localizer Lookup Class A B for BEA WebLogic Server About Logger Classes B-2 Internationalization Guide Example of a Generated Logger Class Internationalization Guide B-3 Listing B-2 shows the corresponding java source generated by i18ngen: B-4 Internationalization Guide Listing B-2 Example of Generated Logger Class Internationalization Guide B-5 B-6 Internationalization Guide Internationalization Guide B-7 B-8 Internationalization Guide Page Page C Reference for BEA About Loggable Objects C How Loggable Objects Are Used How Loggable Objects Are Used Page D Reference for BEA About TextFormatter Classes D-2 Internationalization Guide Example of an Application Using a TextFormatter Class Internationalization Guide D-3 D-4 Internationalization Guide Internationalization Guide D-5 D-6 Internationalization Guide Listing 4-5 shows an example of the generated TextFormatter for the HelloWorld catalog. Internationalization Guide D-7 Listing 4-5 Example of Generated TextFormatter Class for the HelloWorld Catalog D-8 Internationalization Guide Page Page Index A C D E M N O P R