* Create the locale data file using the generator, login to the OOo website and then submit a new issue using [http://www.openoffice.org/issues/enter_bug.cgi?version=current&component=l10n&subcomponent=localedata&issue_type=ENHANCEMENT&assigned_to=er this URL], where you say that it is available. We would then contact Alberto, whom you granted the right to contribute your data, see http://www.it46.se/localegen/copyright.php

* Create the locale data file using the generator, login to the OOo website and then submit a new issue using [http://www.openoffice.org/issues/enter_bug.cgi?version=current&component=l10n&subcomponent=localedata&issue_type=ENHANCEMENT&assigned_to=er this URL], where you say that it is available. We would then contact Alberto, whom you granted the right to contribute your data, see http://www.it46.se/localegen/copyright.php

−

* Or create the locale data file, login to the OOo website and then submit a new issue using [http://www.openoffice.org/issues/enter_bug.cgi?version=current&component=l10n&subcomponent=localedata&issue_type=PATCH&assigned_to=er this URL], and attach the generated file to that issue. <p> Please note that to integrate code or data contributed we need a signed [[Sun Contributor Agreement]] form (SCA) filled-out. </p><p> This would be the preferred way if you plan to do other contributions that would need a signed SCA as well. </p>

+

* Or create the locale data file, login to the OOo website and then submit a new issue using [http://www.openoffice.org/issues/enter_bug.cgi?version=current&component=l10n&subcomponent=localedata&issue_type=PATCH&assigned_to=er this URL], and attach the generated file to that issue. <p> Please note that to integrate code or data contributed we need a signed [[Oracle Contributor Agreement]] form (OCA) filled-out. </p><p> This would be the preferred way if you plan to do other contributions that would need a signed OCA as well. </p>

If you came to this page because an already existing issue pointed you here to

If you came to this page because an already existing issue pointed you here to

Revision as of 20:05, 25 January 2011

Contents

General Information

To be able to fully support a new language or locale
or an already existing but not yet fully supported language/country
combination as a locale, including number formats and calendar data, and
having it selectable as default document language, OOo needs a locale data
file.

Note that several locale data elements may be inherited from another locale's
data by means of the ref="..." attribute if they share identical data,
which may come handy if locales are to be created for the same language but
different countries that differ only in a few elements such as currency
symbols. This would have to be done manually though. Doing so also reduces the
memory footprint needed during runtime when the data libraries are loaded.

If you want to create and contribute a locale data file for your locale, you
can either

Create the locale data file using the generator, login to the OOo website and then submit a new issue using this URL, where you say that it is available. We would then contact Alberto, whom you granted the right to contribute your data, see http://www.it46.se/localegen/copyright.php

Or create the locale data file, login to the OOo website and then submit a new issue using this URL, and attach the generated file to that issue.

This would be the preferred way if you plan to do other contributions that would need a signed OCA as well.

If you came to this page because an already existing issue pointed you here to
submit new locale data, you don't have to create a new issue using one of the
above URLs of course, attach the locale data file to the already existing
issue instead.

Pitfalls

There are a few pitfalls or things to think about when generating locale data:

Index Keys and Scripts

Character Range

In section H. Enumeration and Scripts, the default H1. Character range for indexes
entry is A-Z. If your language uses other characters, e.g. additionally
accented characters, or completely different characters, you probably want to
add them at the proper position. See the generator's documentation and/or the
documentation in the DTD file mentioned above for the LC_INDEX section.

Unicode Script

The preselected BasicLatin and Latin1Supplement scripts usually are
sufficient for Western European languages. If your language uses other or
completely different characters please select the appropriate Unicode
script(s). For the distribution of characters in different Unicode scripts see
The Unicode Character Code Charts By Script.

Currency Formats

The generator in step 3 section I. Currency offers two list boxes,
I6. Currency format for positive values and I7. Currency format for negative values.
While the format for positive values defaulted to $1 (currency symbol
immediately preceding the amount) may be correct, the default format for negative values
($1) (parentheses around symbol and amount, but no minus sign) almost
certainly is not for countries other than US. Please take the time and choose
the correct entries of both list boxes.