dev@woodstock.java.net

Re: Contributing with i18n

From: Jeffrey Chen <Pu.Chen_at_Sun.COM>
Date: Tue, 26 Feb 2008 14:18:49 +0800

Hi Casper,

Please find the English message files and tranlation guideline in
attachment.

    * for_translation.zip: This zip file includes all English message
      file which need to be translated
    * previous_translation_for_reference.zip: This file includes
      previous translations for your reference. No Danish :-(
    * readme: Read it before translation
    * l10n_guide.txt: Translation guideline for woodstock 4.2

If you have other questions, please feel free let me know. Thanks for
your contribution.

Regards,
Jeffrey


Jeffrey Chen 写道:
> Hi Casper,
>
> Glade to know you are going to work on Woodstock localization for
> Danish. :-)
>
> Firstly you can download the Woodstock source code from
> https://woodstock.dev.java.net/Download.htm by following the
> instructions. And here is list for the locations of localized files.
> Please be noticed that all the translated file are in UTF-8 encoding,
> not Unicode-encoded (\udddd notation). It will be converted during the
> build phase.
>
> *
> ./woodstock/themes/src/suntheme/translatedFiles/messages/messages_{lang}.properties
>
> *
> ./woodstock/webui/src/translatedFiles/runtime/com/sun/webui/jsf/model/Bundle_{lang}.properties
>
> *
> ./woodstock/webui/src/translatedFiles/runtime/com/sun/webui/jsf/resources/LogMessages_{lang}.properties
>
> *
> ./woodstock/webui/src/translatedFiles/runtime/com/sun/webui/jsf/component/Bundle_{lang}.properties
>
> *
> ./woodstock/webui/src/translatedFiles/runtime/com/sun/webui/jsf/renderkit/html/Bundle_{lang}.properties
>
> *
> ./woodstock/webui/src/translatedFiles/designtime/com/sun/webui/jsf/Bundle_{lang}.properties
>
> *
> ./woodstock/webui/src/translatedFiles/designtime/com/sun/webui/jsf/design/Bundle_{lang}.properties
>
> *
> ./woodstock/webui/src/translatedFiles/designtime/com/sun/webui/jsf/component/customizers/Bundle-DT_{lang}.properties
>
> *
> ./woodstock/webui/src/translatedFiles/designtime/com/sun/webui/jsf/component/vforms/Bundle_{lang}.properties
>
> *
> ./woodstock/webui/src/translatedFiles/designtime/com/sun/webui/jsf/component/table/Bundle_{lang}.properties
>
> *
> ./woodstock/webui/src/translatedFiles/designtime/com/sun/webui/jsf/component/propertyeditors/Bundle-DT_{lang}.properties
>
> *
> ./woodstock/webui/src/translatedFiles/designtime/com/sun/webui/jsf/component/Bundle-DT_{lang}.properties
>
> *
> ./woodstock/webui/src/translatedFiles/designtime/com/sun/webui/jsf/component/util/Bundle-DT_{lang}.properties
>
> *
> ./woodstock/webui/src/translatedFiles/designtime/com/sun/webui/jsf/component/BeanInfoBundle_{lang}.properties
>
> *
> ./woodstock/webui/src/translatedFiles/designtime/com/sun/webui/jsf/renderkit/html/Bundle-DT_{lang}.properties
>
> *
> ./woodstock/webui/src/translatedFiles/designtime/com/sun/webui/jsf/faces/BeanInfoBundle_{lang}.properties
>
>
> 11 languages are supported for runtime, and 3 languages are supported
> for designtime. Please take a look at it and let's figure out how to
> deliver your translation files soon.
>
> Regards,
> Jeffrey
>
>
> Richard Spellman 写道:
>> That would be a great contribution Casper. Karl and Jeffrey, could
>> you work with Casper on seeing this get into the source tree?
>>
>> Thanks,
>> Dick
>>
>> Casper Bang wrote:
>>> Hello
>>>
>>> I'm missing i18n for Woodstock (Danish) and would like to
>>> contribute. Could I simply download the localizations from trunk at
>>> https://woodstock.dev.java.net/Download.htm, translate the
>>> properties files and submit a link to these to this mailing list or
>>> should I follow another route?
>>>
>>> Thanks,
>>> Casper
>>>
>>> ---------------------------------------------------------------------
>>> To unsubscribe, e-mail: dev-unsubscribe_at_woodstock.dev.java.net
>>> For additional commands, e-mail: dev-help_at_woodstock.dev.java.net
>>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscribe_at_woodstock.dev.java.net
>> For additional commands, e-mail: dev-help_at_woodstock.dev.java.net
>>
>
>



#
# Copyright (c) 2007 by Sun Microsystems, Inc.
# All rights reserved.
#
# l10nguide.txt 1.0 02/25/08 SMI
#


          ==========================================================
                         Localization Guide for
                   woodstock 4.2 - Runtime Components
          ==========================================================
 
This document describes the localizable components for software and
instructions for translating the files for this project. The contents
are in the following order:
 
    1. Localizable Components
 
       1.1 Java properties files

    2. Verification Before Handoff
 
    3. Directory Structure for Handoff


1. Localizable Components
=========================

This project has the following localizable components for
software:

  - Java properties files

The following table lists the file names, targeted languages, and
encoding for translated files that need to be returned to us:

Legend:
  de: German
  es: Spanish (unified Spanish)
  fr: French
  it: Italian
  ja: Japanese
  ko: Korean
  zh, zh_CN: Simplified Chinese
  zh_TW, zh_HK: Traditional Chinese
  pt_BR: Brazilian Portuguese
  sv: Swedish

================+==============================================================
Component | Language and encoding
================+=====+=====+=====+=====+=====+=====+=====+=====+=======+======
                | de | es | fr | it |pt_BR| ja | ko | zh | zh_TW | sv
----------------+-----+-----+-----+-----+-----+-----+--------------------------
Properties files| X | X | X | X | X | X | X | X | X | X
                +-----+-----+-----+-----+-----+-----+-----+-----+-------+------
(.properties) | UTF-8 encoding
----------------+-----+-----+-----+-----+-----+-----+-----+--------------------



[Properties files] (Number of files: 1)

webuiui-jsf-suntheme/com/sun/webui/jsf/suntheme/messages/messages.properties.handoff

1.1 Java properties files
=========================

o Translate the messages directly in the delivered file.
  The file contains messages to be translated only and IS NOT
  a complete properties file.

o Translate the property values as indicated below:

   property_name=property_value
                 --------------
                 Translate this portion.

Here are some important notes for translating the Java properties files:

(1) When changing the value of a property, it is important that only the
    property_value be changed and not the property_name.

(2) Lines in the properties file beginning with a '#' character are
    comments. They need not be modified.

(3) If a property_value contains one or more '{#}' sets, where # is a
    number, the translated message must also contain these sets of
    characters. The Java programs replace the {#}'s with text.
    The translator may change the order of the sets but the number
    of sets must be kept the same.

(4) Encoding of *.properties files should be UTF-8 encoding

(5) When you ADD '(apostrophe) to the property as the result of translation
    (this often happens in European languages such as Italian or French),
    you sometimes need to add extra '(apostrophe).

    Unless any specific informations are given, the following explains
    the generic rule - when you need to add an extra ', and when
    you don't.


    (5-a) You do NOT need to add an extra apostrophe.

          `property_name_A`=bla bla bla (English)

          `property_name_A`=bla'd bla'd bla'd (an European language)

    (5-b) You NEED to add an extra apostrophe.

          `property_name_A`=bla {0} bla {1} bla (English)

          `property_name_A`=bla''d {0} bla''d {1} bla''d (an European language)

   
    When you see {#} in a line in a property file, you need to add an
    extra apostrophe for that line, and not if you don't see {#}.
 
    Please note that we may still provide a specific instruction on
    the special usage of ' during the project.

(6) <> Keep them as they are.

(7) When you encounter a line in a properties file that looks something like:
        
        property_name={x}:{x,number,integer} property_value

    You only need to translate the property_value and not the objects before it.

    For example, for the following line:

       modules.isload={0}: {1,number,integer} instance(s) loaded

    In this case, you only translate "instance(s) loaded".

(8) If a message spans multiple lines, you must terminate each line
    (except the last) with the line continuation character: '\'.

(9) If a continued line starts with whitespace you must begin the line
    with the '\' character in the first column to preserve the leading
    whitespace.

2. Verification Before Handoff
==============================

After translation is completed, please verify integrity of the files
before sending them to us.

Please verify the following:

  - Encoding
  - File format (should have UNIX end-of-line, not MS-DOS or MAC)


3. Directory Structure for Handoff
==================================

Please return the translated files in a "tar" file a language.
So, if you handoff files for 4 languages, you should create 4 "tar" files.
In "tar" files, the translated files should be in the same directory
structure (= same directory and file names). Be careful not to merge
the translated files for multiple languages into a "tar" files, because
each file has the same pathname.

[EOF]



1. There is a list for the files which are needed for tanslation. Totol 16 files.

-----------------------
woodstock themes File
Language: Total 11 languages. de, es, fr, it, ja, ko, pt_BR, sv, zh_CN, zh_HK, zh_TW (zh_TW has same translation with zh_HK)
-----------------------
./themes/src/suntheme/translatedFiles/messages/messages.properties


-----------------------
woodstock webui runtime Files
Language: Total 11 languages. de, es, fr, it, ja, ko, pt_BR, sv, zh_CN, zh_HK, zh_TW (zh_TW has same translation with zh_HK)
-----------------------
./webui/src/translatedFiles/runtime/com/sun/webui/jsf/model/Bundle.properties
./webui/src/translatedFiles/runtime/com/sun/webui/jsf/resources/LogMessages.properties
./webui/src/translatedFiles/runtime/com/sun/webui/jsf/component/Bundle.properties
./webui/src/translatedFiles/runtime/com/sun/webui/jsf/renderkit/html/Bundle.properties


-----------------------
woodstock webui designtime Files
Language: Total 3 languages. zh_CN, ja, pt_BR
-----------------------
./webui/src/translatedFiles/designtime/com/sun/webui/jsf/Bundle.properties
./webui/src/translatedFiles/designtime/com/sun/webui/jsf/design/Bundle.properties
./webui/src/translatedFiles/designtime/com/sun/webui/jsf/component/customizers/Bundle-DT.properties
./webui/src/translatedFiles/designtime/com/sun/webui/jsf/component/vforms/Bundle.properties
./webui/src/translatedFiles/designtime/com/sun/webui/jsf/component/table/Bundle.properties
./webui/src/translatedFiles/designtime/com/sun/webui/jsf/component/propertyeditors/Bundle-DT.properties
./webui/src/translatedFiles/designtime/com/sun/webui/jsf/component/util/Bundle-DT.properties
./webui/src/translatedFiles/designtime/com/sun/webui/jsf/component/Bundle-DT.properties
./webui/src/translatedFiles/designtime/com/sun/webui/jsf/component/BeanInfoBundle.properties
./webui/src/translatedFiles/designtime/com/sun/webui/jsf/renderkit/html/Bundle-DT.properties
./webui/src/translatedFiles/designtime/com/sun/webui/jsf/faces/BeanInfoBundle.properties

2. Please use privious translation as reference.

3. There is a file - l10n_guide.txt, which can be used for translation guideline.