Warning, /frameworks/kdelibs4support/src/l10n/README is written in an unsupported language. File is not indexed.
0001 GENERAL 0002 ======= 0003 0004 In KDE we support localization of calendars, dates, time, numbers and 0005 money. KDE will use this when displaying such information, giving you 0006 a feeling that KDE was written to fit your national standards. To make 0007 this possible, we need to gather some information on your national 0008 standards. Currently there are some 237 countries supported. If your 0009 country is missing, please let us know. 0010 0011 The official ISO codes unsupported as at 18/11/2008 are: 0012 0013 * AQ Antarctica 0014 * BV Bouvet Island 0015 * GS South Georgia and the South Sandwich Islands 0016 * HM Heard Island and MacDonald Islands 0017 * IO British Indian Ocean Territory 0018 * SJ Svalbard and Jan Mayen 0019 * TF French Southern Territories 0020 * UM United States Minor Outlying Islands 0021 0022 Of these, the following codes are likely to be considered for support: 0023 0024 * SJ Svalbard and Jan Mayen 0025 0026 The other codes are unlikely to be considered due to lack of population. 0027 0028 HOW TO ADD INFORMATION 0029 ====================== 0030 First you have to write a file called "entry.desktop". This file will 0031 describe your national standards. Please read the section below for 0032 more information on that. Please use the file "country.template" as 0033 template. 0034 0035 You will need a nice flag for your country. The size should be 21x14 0036 pixels, and it should be called "flag.png". 0037 0038 To add your information, we need a two letter country code for you country. 0039 Use http://www.iso.org/iso/country_codes/ or the entities.csv document in 0040 this folder as a guide. 0041 0042 Now you are done, and you can submit the files to KDE project by adding a wish 0043 item on bugs.kde.org under Product kdelibs Componant KLocale. The files will be 0044 added in the next release. 0045 0046 WHAT IS ENTRY.DESKTOP 0047 ===================== 0048 entry.desktop is a file which defines a locale for a country. It's 0049 stored the same way as the rest of the KDE configuration files. The 0050 very first line should only contain "[KCM Locale]". The rest of the 0051 file should contain one line for each of the entries below. Add "=" 0052 between the entry name and the value. 0053 0054 * Author 0055 The name of the email address to reach you. 0056 0057 Default: blank 0058 0059 * Name 0060 The name of the country in English. 0061 0062 Default: blank 0063 0064 * Region 0065 0066 Defines which submenu the country belongs to. Currently there are 20 different regions 0067 conforming to the United Nations statistical regions, excluding the Oceania sub-divisions, 0068 but adding Central Europe. See http://unstats.un.org/unsd/methods/m49/m49regin.htm for details. 0069 0070 centralasia (Central Asia) 0071 eastasia (East Asia) 0072 southasia (South Asia) 0073 southeastasia (South-East Asia) 0074 middleeast (Middle-East/West Asia) 0075 centralafrica (Central Africa) 0076 northafrica (Northern Africa) 0077 southafrica (Southern Africa) 0078 westafrica (Western Africa) 0079 eastafrica (Eastern Africa) 0080 easteurope (Eastern Europe) 0081 westeurope (Western Europe) 0082 southeurope (Southern Europe) 0083 northeurope (Northern Europe) 0084 centraleurope (Central Europe) 0085 northamerica (North America) 0086 southamerica (South America) 0087 centralemarica (Central America) 0088 caribbean (Caribbean) 0089 oceania (Oceania) 0090 0091 Default: blank 0092 0093 * Languages 0094 A comma separated list of locale codes for the official languages 0095 of the country. 0096 0097 Default: blank 0098 0099 * DecimalSymbol 0100 The symbol that separates the decimals from the rest of the 0101 number. 0102 0103 Default: "." 0104 0105 * DecimalPlaces 0106 The number of decimal places to display in a formatted number 0107 0108 Default: 2 0109 0110 * ThousandsSeparator 0111 Thousands separator. 0112 0113 Default: "," 0114 0115 * DigitSet 0116 The set of digits used to display numbers. 0117 0118 0 Arabic 0119 1 Arabic-Indic 0120 2 Eastern Arabic-Indic 0121 3 Devenagari 0122 0123 Default: 0 0124 0125 0126 * CurrencyCode 0127 The ISO Code of the primary currency used in the country. 0128 0129 Default: "USD" 0130 0131 * CurrencyCodesInUse 0132 A list of ISO Codes of all the currencies used in the country. 0133 0134 Default: "USD" 0135 0136 * MonetaryDecimalSymbol 0137 The symbol that separates the decimals from the rest of the number 0138 when displaying. 0139 0140 Default: "." 0141 0142 * MonetaryDecimalPlaces 0143 The number of decimal places to display in a formatted money amount 0144 0145 Default: 2 0146 0147 * MonetaryThousandsSeparator 0148 Thousands separator for money. 0149 0150 Default: "," 0151 0152 * MonetaryDigitSet 0153 The set of digits used to display money amounts. 0154 0155 See DigitSet for possible values. 0156 0157 Default: 0 0158 0159 * PositiveSign 0160 Positive sign for money. 0161 Note: this will be used for formatting numbers. Do not add "+" if 0162 you don't really want numbers to be formatted that way. 0163 0164 Default: "" 0165 0166 * NegativeSign 0167 Negative sign for money. 0168 0169 Default: "-" 0170 0171 * PositivePrefixCurrencySymbol 0172 If currency symbol should be prepended (if not, it will be 0173 appended). This is for non-negative money values. 0174 0175 Default: true 0176 0177 * NegativePrefixCurrencySymbol 0178 If currency symbol should be prepended (if not, it will be 0179 appended). This is for negative money values. 0180 0181 Default: true 0182 0183 * PositiveMonetarySignPosition 0184 Defines which type and where the sign (if it's positive or 0185 negative) should be placed. This is for non-negative money values. 0186 0187 0 ParensAround 0188 1 BeforeQuantityMoney 0189 2 AfterQuantityMoney 0190 3 BeforeMoney 0191 4 AfterMoney 0192 0193 Default: 1 0194 0195 * NegativeMonetarySignPosition 0196 Same as PositiveMonetarySignPosition, but for negative numbers. 0197 0198 Default: 0 0199 0200 * DateFormat[language code] 0201 This defines how a date is formated. The date string will be 0202 contructed from this string and the sequences below will be 0203 replaced. This should be marked with a language code as well for 0204 each supported language. 0205 0206 %Y The year with century as a decimal number. 0207 %y The year without century as a decimal number (00-99). 0208 %m The month as a decimal number (01-12). 0209 %n The month as a decimal number (1-12). 0210 %b The national representation of the abbreviated month name, 0211 where the abbreviation is the first three characters. 0212 %B The national representation of the full month name. 0213 %d The day of month as a decimal number (01-31). 0214 %e The day of month as a decimal number (1-31). 0215 %a The national representation of the abbreviated weekday name, 0216 where the abbreviation is the first three characters. 0217 %A The national representation of the full weekday name. 0218 0219 Default: "%A %d %B %Y" 0220 0221 * DateFormatShort 0222 This is the same as DateFormat, but is used when the program asks 0223 for a short date. Usally this is used when listing files etc. 0224 0225 Default: "%Y-%m-%d" 0226 0227 * TimeFormat 0228 This defines how a times are formated. The date string will be 0229 contructed from this string and the sequences below will be 0230 replaced. 0231 0232 %H The hour as a decimal number using a 24-hour clock (range 00 to 0233 23). 0234 %k The hour (24-hour clock) as a decimal number (range 0 to 23). 0235 %I The hour as a decimal number using a 12-hour clock (range 01 to 0236 12). 0237 %l The hour (12-hour clock) as a decimal number (range 1 to 12). 0238 %M The minute as a decimal number (range 00 to 59). 0239 %S The second as a decimal number (range 00 to 59). 0240 %p Either AM or PM according to the given time value. AM or PM are 0241 translating to the current language. Noon is treated as PM 0242 and midnight as AM. 0243 0244 Default: "%H:%M:%S" 0245 0246 * DateTimeDigitSet 0247 The set of digits used to display date and time numbers. 0248 0249 See DigitSet for possible values. 0250 0251 Default: 0 0252 0253 * WeekStartDay 0254 This defines which day is the first of the week. Accepted value is 0255 an integer number where 1 means Monday, 2 Tuesday, and so on. 0256 0257 Default: 1 0258 0259 * WorkingWeekStartDay 0260 This defines which day is the first working day of the week. Accepted 0261 value is an integer number where 1 means Monday, 2 Tuesday, and so on. 0262 0263 Default: 1 0264 0265 * WorkingWeekEndDay 0266 This defines which day is the last working day of the week. Accepted 0267 value is an integer number where 1 means Monday, 2 Tuesday, and so on. 0268 0269 Default: 5 0270 0271 * WeekDayOfPray 0272 This defines which day is the day of the week for religious observance. 0273 Accepted value is an integer number where 1 means Monday, 2 Tuesday, 0274 and so on. A special value of 0 means no day of religious observance. 0275 0276 Default: 7 0277 0278 * MeasureSystem 0279 This defines which measure system we should use. There are two 0280 values here, 0 for Metric and 1 for Imperial. Metric would give 0281 you meters (or cm/mm), while Imperial would give you inches. 0282 0283 Default: 0 0284 0285 * PageSize 0286 This defines which page size we should use by default. It should 0287 be the number of the item in the QPrinter::PageSize enum. Here are 0288 some values: 0289 0290 0 A4 0291 1 B5 0292 2 US Letter 0293 ...and so on 0294 0295 Default: 0 0296 0297 * CalendarSystem 0298 This defines which calendar system to use. Available systems are: 0299 0300 gregorian 0301 hebrew 0302 hijri 0303 jalali 0304 indian-national 0305 ethiopian 0306 coptic 0307 0308 Default: gregorian 0309 0310 * AddressFormat 0311 * BusinessAddressFormat 0312 * AddressCountryPosition 0313 These fields define the formatting of postal addresses. For 0314 detailled information on these fields' format, please refer to 0315 kdepimlibs/kabc/README.AddressFormat 0316 0317 Hans Petter Bieker <bieker@kde.org> 0318 Lukas Tinkl <lukas@kde.org> 0319 John Layt <john@layt.net>