runtime/l10n/README

   1 GENERAL
   2 =======
   3
   4 In KDE we support localization of calendars, dates, time, numbers and
   5 money. KDE will use this when displaying such information, giving you
   6 a feeling that KDE was written to fit your national standards. To make
   7 this possible, we need to gather some information on your national
   8 standards. Currently there are some 228 countries supported. If your
   9 country is missing, please let us know.
  10
  11 The official ISO codes unsupported as at 18/11/2008 are:
  12
  13     * AQ Antarctica
  14     * BL Saint Barthelemy
  15     * BV Bouvet Island
  16     * GF French Guiana
  17     * GG Guernsey
  18     * GS South Georgia and the South Sandwich Islands
  19     * HM Heard Island and MacDonald Islands
  20     * IM Isle of Man
  21     * IO British Indian Ocean Territory
  22     * JE Jersey
  23     * MF Saint Martin
  24     * MP Northern Mariana Islands
  25     * RE Reunion
  26     * SJ Svalbard and Jan Mayen
  27     * TF French Southern Territories
  28     * UM United States Minor Outlying Islands
  29     * YT Mayotte
  30
  31 Of these, the following codes are likely to be considered for support:
  32
  33     * BL Saint Barthelemy
  34     * GF French Guiana
  35     * GG Guernsey
  36     * IM Isle of Man
  37     * JE Jersey
  38     * MF Saint Martin
  39     * MP Northern Mariana Islands
  40     * RE Reunion
  41     * SJ Svalbard and Jan Mayen
  42     * YT Mayotte
  43
  44 HOW TO ADD INFORMATION
  45 ======================
  46 First you have to write a file called "entry.desktop". This file will
  47 describe your national standards. Please read the section below for
  48 more information on that. Please use the file "country.template" as
  49 template.
  50
  51 You will need a nice flag for your country. The size should be 21x14
  52 pixels, and it should be called "flag.png".
  53
  54 To add your information, we need a two letter country code for you country.
  55 Use http://www.iso.org/iso/country_codes/ or the entities.csv document in
  56 this folder as a guide.
  57
  58 Now you are done, and you can submit the files to KDE project by
  59 sending a mail to Hans Petter Bieker <bieker@kde.org>. The files will
  60 be added in the next release. Please include the country code in the
  61 mail.
  62
  63 WHAT IS ENTRY.DESKTOP
  64 =====================
  65 entry.desktop is a file which defines a locale for a country. It's
  66 stored the same way as the rest of the KDE configuration files. The
  67 very first line should only contain "[KCM Locale]". The rest of the
  68 file should contain one line for each of the entries below. Add "="
  69 between the entry name and the value.
  70
  71 * Author
  72         The name of the email address to reach you.
  73
  74         Default: blank
  75
  76 * Name
  77         The name of the country in English.
  78
  79         Default: blank
  80
  81 * Region
  82
  83     Defines which submenu the country belongs to. Currently there are 20 different regions
  84     conforming to the United Nations statistical regions, excluding the Oceania sub-divisions,
  85     but adding Central Europe. See http://unstats.un.org/unsd/methods/m49/m49regin.htm for details.
  86
  87         centralasia    (Central Asia)
  88         eastasia       (East Asia)
  89         southasia      (South Asia)
  90         southeastasia  (South-East Asia)
  91         middleeast     (Middle-East/West Asia)
  92         centralafrica  (Central Africa)
  93         northafrica    (Northern Africa)
  94         southafrica    (Southern Africa)
  95         westafrica     (Western Africa)
  96         eastafrica     (Eastern Africa)
  97         easteurope     (Eastern Europe)
  98         westeurope     (Western Europe)
  99         southeurope    (Southern Europe)
 100         northeurope    (Northern Europe)
 101         centraleurope  (Central Europe)
 102         northamerica   (North America)
 103         southamerica   (South America)
 104         centralemarica (Central America)
 105         caribbean      (Caribbean)
 106         oceania        (Oceania)
 107
 108         Default: blank
 109
 110 * Languages
 111         A comma separated list of locale codes for the official languages
 112         of the country.
 113
 114         Default: blank
 115
 116 * DecimalSymbol
 117         The symbol that separates the decimals from the rest of the
 118         number.
 119
 120         Default: "."
 121
 122 * ThousandsSeparator
 123         Thousands separator.
 124
 125         Default: ","
 126
 127 * CurrencySymbol
 128         The symbol of the currency used in the country.
 129
 130         Default: "$"
 131
 132 * MonetaryDecimalSymbol
 133         The symbol that separates the decimals from the rest of the number
 134         when displaying.
 135
 136         Default: "."
 137
 138 * MonetaryThousandsSeparator
 139         Thousands separator for money.
 140
 141         Default: ","
 142
 143 * PositiveSign
 144         Positive sign for money.
 145         Note: this will be used for formatting numbers. Do not add "+" if
 146               you don't really want numbers to be formatted that way.
 147
 148         Default: ""
 149
 150 * NegativeSign
 151         Negative sign for money.
 152
 153         Default: "-"
 154
 155 * FracDigits
 156         Number fract digits used for money
 157
 158         Default: 2
 159
 160 * PositivePrefixCurrencySymbol
 161         If currency symbol should be prepended (if not, it will be
 162         appended). This is for non-negative money values.
 163
 164         Default: true
 165
 166 * NegativePrefixCurrencySymbol
 167         If currency symbol should be prepended (if not, it will be
 168         appended). This is for negative money values.
 169
 170         Default: true
 171
 172 * PositiveMonetarySignPosition
 173         Defines which type and where the sign (if it's positive or
 174         negative) should be placed. This is for non-negative money values.
 175
 176         0 ParensAround
 177         1 BeforeQuantityMoney
 178         2 AfterQuantityMoney
 179         3 BeforeMoney
 180         4 AfterMoney
 181
 182         Default: 1
 183
 184 * NegativeMonetarySignPosition
 185         Same as PositiveMonetarySignPosition, but for negative numbers.
 186
 187         Default: 0
 188
 189 * DateFormat[language code]
 190         This defines how a date is formated. The date string will be
 191     contructed from this string and the sequences below will be
 192     replaced. This should be marked with a language code as well for
 193     each supported language.
 194
 195         %Y The year with century as a decimal number.
 196         %y The year without century as a decimal number (00-99).
 197         %m The month as a decimal number (01-12).
 198         %n The month as a decimal number (1-12).
 199         %b The national representation of the abbreviated month name,
 200            where the abbreviation is the first three characters.
 201         %B The national representation of the full month name.
 202         %d The day of month as a decimal number (01-31).
 203         %e The day of month as a decimal number (1-31).
 204         %a The national representation of the abbreviated weekday name,
 205            where the abbreviation is the first three characters.
 206         %A The national representation of the full weekday name.
 207
 208         Default: "%A %d %B %Y"
 209
 210 * DateFormatShort
 211         This is the same as DateFormat, but is used when the program asks
 212         for a short date. Usally this is used when listing files etc.
 213
 214         Default: "%Y-%m-%d"
 215
 216 * TimeFormat
 217         This defines how a times are formated. The date string will be
 218     contructed from this string and the sequences below will be
 219     replaced.
 220
 221         %H The hour as a decimal number using a 24-hour clock (range 00 to
 222                    23).
 223         %k The hour (24-hour clock) as a decimal number (range 0 to 23).
 224         %I The hour as a decimal number using a 12-hour clock (range 01 to
 225            12).
 226         %l The hour (12-hour clock) as a decimal number (range 1 to 12).
 227         %M The minute as a decimal number (range 00 to 59).
 228         %S The second as a decimal number (range 00 to 59).
 229         %p Either AM or PM according to the given time value. AM or PM are
 230            translating to the current language. Noon is treated as PM
 231            and midnight as AM.
 232
 233         Default: "%H:%M:%S"
 234
 235 * WeekStartDay
 236         This defines which day is the first of the week. Accepted value is
 237         an integer number where 1 means Monday, 2 Tuesday, and so on.
 238
 239         Default: 1
 240
 241 * WorkingWeekStartDay
 242         This defines which day is the first working day of the week. Accepted
 243         value is an integer number where 1 means Monday, 2 Tuesday, and so on.
 244
 245         Default: 1
 246
 247 * WorkingWeekEndDay
 248         This defines which day is the last working day of the week. Accepted
 249         value is an integer number where 1 means Monday, 2 Tuesday, and so on.
 250
 251         Default: 5
 252
 253 * WeekDayOfPray
 254         This defines which day is the day of the week for religious observance.
 255         Accepted value is an integer number where 1 means Monday, 2 Tuesday,
 256         and so on. A special value of 0 means no day of religious observance.
 257
 258         Default: 7
 259
 260 * MeasureSystem
 261         This defines which measure system we should use. There are two
 262         values here, 0 for Metric and 1 for Imperial. Metric would give
 263         you meters (or cm/mm), while Imperial would give you inches.
 264
 265         Default: 0
 266
 267 * PageSize
 268         This defines which page size we should use by default. It should
 269         be the number of the item in the QPrinter::PageSize enum. Here are
 270         some values:
 271
 272         0       A4
 273         1       B5
 274         2       US Letter
 275         ...and so on
 276
 277         Default: 0
 278
 279 * CalendarSystem
 280         This defines which calendar system to use. Available systems are:
 281
 282         gregorian
 283         hebrew
 284         hijri
 285         jalali
 286
 287         Default: gregorian
 288
 289 * AddressFormat
 290 * BusinessAddressFormat
 291 * AddressCountryPosition
 292         These fields define the formatting of postal addresses. For
 293         detailled information on these fields' format, please refer to
 294         kdelibs/kabc/README.AddressFormat
 295
 296 Hans Petter Bieker <bieker@kde.org>
 297 Lukas Tinkl <lukas@kde.org>
 298 John Layt <john@layt.net>