mirror of
https://bitbucket.org/smil3y/kde-workspace.git
synced 2025-02-23 18:32:50 +00:00
319 lines
8.8 KiB
Text
319 lines
8.8 KiB
Text
GENERAL
|
|
=======
|
|
|
|
In KDE we support localization of calendars, dates, time, numbers and
|
|
money. KDE will use this when displaying such information, giving you
|
|
a feeling that KDE was written to fit your national standards. To make
|
|
this possible, we need to gather some information on your national
|
|
standards. Currently there are some 237 countries supported. If your
|
|
country is missing, please let us know.
|
|
|
|
The official ISO codes unsupported as at 18/11/2008 are:
|
|
|
|
* AQ Antarctica
|
|
* BV Bouvet Island
|
|
* GS South Georgia and the South Sandwich Islands
|
|
* HM Heard Island and MacDonald Islands
|
|
* IO British Indian Ocean Territory
|
|
* SJ Svalbard and Jan Mayen
|
|
* TF French Southern Territories
|
|
* UM United States Minor Outlying Islands
|
|
|
|
Of these, the following codes are likely to be considered for support:
|
|
|
|
* SJ Svalbard and Jan Mayen
|
|
|
|
The other codes are unlikely to be considered due to lack of population.
|
|
|
|
HOW TO ADD INFORMATION
|
|
======================
|
|
First you have to write a file called "entry.desktop". This file will
|
|
describe your national standards. Please read the section below for
|
|
more information on that. Please use the file "country.template" as
|
|
template.
|
|
|
|
You will need a nice flag for your country. The size should be 21x14
|
|
pixels, and it should be called "flag.png".
|
|
|
|
To add your information, we need a two letter country code for you country.
|
|
Use http://www.iso.org/iso/country_codes/ or the entities.csv document in
|
|
this folder as a guide.
|
|
|
|
Now you are done, and you can submit the files to KDE project by adding a wish
|
|
item on bugs.kde.org under Product kdelibs Componant KLocale. The files will be
|
|
added in the next release.
|
|
|
|
WHAT IS ENTRY.DESKTOP
|
|
=====================
|
|
entry.desktop is a file which defines a locale for a country. It's
|
|
stored the same way as the rest of the KDE configuration files. The
|
|
very first line should only contain "[KCM Locale]". The rest of the
|
|
file should contain one line for each of the entries below. Add "="
|
|
between the entry name and the value.
|
|
|
|
* Author
|
|
The name of the email address to reach you.
|
|
|
|
Default: blank
|
|
|
|
* Name
|
|
The name of the country in English.
|
|
|
|
Default: blank
|
|
|
|
* Region
|
|
|
|
Defines which submenu the country belongs to. Currently there are 20 different regions
|
|
conforming to the United Nations statistical regions, excluding the Oceania sub-divisions,
|
|
but adding Central Europe. See http://unstats.un.org/unsd/methods/m49/m49regin.htm for details.
|
|
|
|
centralasia (Central Asia)
|
|
eastasia (East Asia)
|
|
southasia (South Asia)
|
|
southeastasia (South-East Asia)
|
|
middleeast (Middle-East/West Asia)
|
|
centralafrica (Central Africa)
|
|
northafrica (Northern Africa)
|
|
southafrica (Southern Africa)
|
|
westafrica (Western Africa)
|
|
eastafrica (Eastern Africa)
|
|
easteurope (Eastern Europe)
|
|
westeurope (Western Europe)
|
|
southeurope (Southern Europe)
|
|
northeurope (Northern Europe)
|
|
centraleurope (Central Europe)
|
|
northamerica (North America)
|
|
southamerica (South America)
|
|
centralemarica (Central America)
|
|
caribbean (Caribbean)
|
|
oceania (Oceania)
|
|
|
|
Default: blank
|
|
|
|
* Languages
|
|
A comma separated list of locale codes for the official languages
|
|
of the country.
|
|
|
|
Default: blank
|
|
|
|
* DecimalSymbol
|
|
The symbol that separates the decimals from the rest of the
|
|
number.
|
|
|
|
Default: "."
|
|
|
|
* DecimalPlaces
|
|
The number of decimal places to display in a formatted number
|
|
|
|
Default: 2
|
|
|
|
* ThousandsSeparator
|
|
Thousands separator.
|
|
|
|
Default: ","
|
|
|
|
* DigitSet
|
|
The set of digits used to display numbers.
|
|
|
|
0 Arabic
|
|
1 Arabic-Indic
|
|
2 Eastern Arabic-Indic
|
|
3 Devenagari
|
|
|
|
Default: 0
|
|
|
|
|
|
* CurrencyCode
|
|
The ISO Code of the primary currency used in the country.
|
|
|
|
Default: "USD"
|
|
|
|
* CurrencyCodesInUse
|
|
A list of ISO Codes of all the currencies used in the country.
|
|
|
|
Default: "USD"
|
|
|
|
* MonetaryDecimalSymbol
|
|
The symbol that separates the decimals from the rest of the number
|
|
when displaying.
|
|
|
|
Default: "."
|
|
|
|
* MonetaryDecimalPlaces
|
|
The number of decimal places to display in a formatted money amount
|
|
|
|
Default: 2
|
|
|
|
* MonetaryThousandsSeparator
|
|
Thousands separator for money.
|
|
|
|
Default: ","
|
|
|
|
* MonetaryDigitSet
|
|
The set of digits used to display money amounts.
|
|
|
|
See DigitSet for possible values.
|
|
|
|
Default: 0
|
|
|
|
* PositiveSign
|
|
Positive sign for money.
|
|
Note: this will be used for formatting numbers. Do not add "+" if
|
|
you don't really want numbers to be formatted that way.
|
|
|
|
Default: ""
|
|
|
|
* NegativeSign
|
|
Negative sign for money.
|
|
|
|
Default: "-"
|
|
|
|
* PositivePrefixCurrencySymbol
|
|
If currency symbol should be prepended (if not, it will be
|
|
appended). This is for non-negative money values.
|
|
|
|
Default: true
|
|
|
|
* NegativePrefixCurrencySymbol
|
|
If currency symbol should be prepended (if not, it will be
|
|
appended). This is for negative money values.
|
|
|
|
Default: true
|
|
|
|
* PositiveMonetarySignPosition
|
|
Defines which type and where the sign (if it's positive or
|
|
negative) should be placed. This is for non-negative money values.
|
|
|
|
0 ParensAround
|
|
1 BeforeQuantityMoney
|
|
2 AfterQuantityMoney
|
|
3 BeforeMoney
|
|
4 AfterMoney
|
|
|
|
Default: 1
|
|
|
|
* NegativeMonetarySignPosition
|
|
Same as PositiveMonetarySignPosition, but for negative numbers.
|
|
|
|
Default: 0
|
|
|
|
* DateFormat[language code]
|
|
This defines how a date is formated. The date string will be
|
|
contructed from this string and the sequences below will be
|
|
replaced. This should be marked with a language code as well for
|
|
each supported language.
|
|
|
|
%Y The year with century as a decimal number.
|
|
%y The year without century as a decimal number (00-99).
|
|
%m The month as a decimal number (01-12).
|
|
%n The month as a decimal number (1-12).
|
|
%b The national representation of the abbreviated month name,
|
|
where the abbreviation is the first three characters.
|
|
%B The national representation of the full month name.
|
|
%d The day of month as a decimal number (01-31).
|
|
%e The day of month as a decimal number (1-31).
|
|
%a The national representation of the abbreviated weekday name,
|
|
where the abbreviation is the first three characters.
|
|
%A The national representation of the full weekday name.
|
|
|
|
Default: "%A %d %B %Y"
|
|
|
|
* DateFormatShort
|
|
This is the same as DateFormat, but is used when the program asks
|
|
for a short date. Usally this is used when listing files etc.
|
|
|
|
Default: "%Y-%m-%d"
|
|
|
|
* TimeFormat
|
|
This defines how a times are formated. The date string will be
|
|
contructed from this string and the sequences below will be
|
|
replaced.
|
|
|
|
%H The hour as a decimal number using a 24-hour clock (range 00 to
|
|
23).
|
|
%k The hour (24-hour clock) as a decimal number (range 0 to 23).
|
|
%I The hour as a decimal number using a 12-hour clock (range 01 to
|
|
12).
|
|
%l The hour (12-hour clock) as a decimal number (range 1 to 12).
|
|
%M The minute as a decimal number (range 00 to 59).
|
|
%S The second as a decimal number (range 00 to 59).
|
|
%p Either AM or PM according to the given time value. AM or PM are
|
|
translating to the current language. Noon is treated as PM
|
|
and midnight as AM.
|
|
|
|
Default: "%H:%M:%S"
|
|
|
|
* DateTimeDigitSet
|
|
The set of digits used to display date and time numbers.
|
|
|
|
See DigitSet for possible values.
|
|
|
|
Default: 0
|
|
|
|
* WeekStartDay
|
|
This defines which day is the first of the week. Accepted value is
|
|
an integer number where 1 means Monday, 2 Tuesday, and so on.
|
|
|
|
Default: 1
|
|
|
|
* WorkingWeekStartDay
|
|
This defines which day is the first working day of the week. Accepted
|
|
value is an integer number where 1 means Monday, 2 Tuesday, and so on.
|
|
|
|
Default: 1
|
|
|
|
* WorkingWeekEndDay
|
|
This defines which day is the last working day of the week. Accepted
|
|
value is an integer number where 1 means Monday, 2 Tuesday, and so on.
|
|
|
|
Default: 5
|
|
|
|
* WeekDayOfPray
|
|
This defines which day is the day of the week for religious observance.
|
|
Accepted value is an integer number where 1 means Monday, 2 Tuesday,
|
|
and so on. A special value of 0 means no day of religious observance.
|
|
|
|
Default: 7
|
|
|
|
* MeasureSystem
|
|
This defines which measure system we should use. There are two
|
|
values here, 0 for Metric and 1 for Imperial. Metric would give
|
|
you meters (or cm/mm), while Imperial would give you inches.
|
|
|
|
Default: 0
|
|
|
|
* PageSize
|
|
This defines which page size we should use by default. It should
|
|
be the number of the item in the QPrinter::PageSize enum. Here are
|
|
some values:
|
|
|
|
0 A4
|
|
1 B5
|
|
2 US Letter
|
|
...and so on
|
|
|
|
Default: 0
|
|
|
|
* CalendarSystem
|
|
This defines which calendar system to use. Available systems are:
|
|
|
|
gregorian
|
|
hebrew
|
|
hijri
|
|
jalali
|
|
indian-national
|
|
ethiopian
|
|
coptic
|
|
|
|
Default: gregorian
|
|
|
|
* AddressFormat
|
|
* BusinessAddressFormat
|
|
* AddressCountryPosition
|
|
These fields define the formatting of postal addresses. For
|
|
detailled information on these fields' format, please refer to
|
|
kdepimlibs/kabc/README.AddressFormat
|
|
|
|
Hans Petter Bieker <bieker@kde.org>
|
|
Lukas Tinkl <lukas@kde.org>
|
|
John Layt <john@layt.net>
|