Git commit c86ff5303d51eff49caa2187ef5e188bc0426422 by Burkhard Lück. Committed on 28/05/2015 at 09:29. Pushed by lueck into branch 'master'.
Split obsolete language docbook into translations + format docbook REVIEW:123855 M +27 -28 doc/kcontrol/CMakeLists.txt C +1 -1 doc/kcontrol/formats/CMakeLists.txt [from: doc/kcontrol/language/CMakeLists.txt - 070% similarity] A +63 -0 doc/kcontrol/formats/index.docbook D +0 -633 doc/kcontrol/language/index.docbook D +- -- doc/kcontrol/language/oxygen-22x22-document-revert.png R +1 -1 doc/kcontrol/translations/CMakeLists.txt [from: doc/kcontrol/language/CMakeLists.txt - 068% similarity] A +92 -0 doc/kcontrol/translations/index.docbook http://commits.kde.org/plasma-desktop/c86ff5303d51eff49caa2187ef5e188bc0426422 diff --git a/doc/kcontrol/CMakeLists.txt b/doc/kcontrol/CMakeLists.txt index c2f27d5..df26a0f 100644 --- a/doc/kcontrol/CMakeLists.txt +++ b/doc/kcontrol/CMakeLists.txt @@ -19,34 +19,33 @@ ecm_optional_add_subdirectory(khtml-adblock) ecm_optional_add_subdirectory(emoticons) ecm_optional_add_subdirectory(baloo) -if ( Q_WS_X11 ) - ecm_optional_add_subdirectory(autostart) - ecm_optional_add_subdirectory(bell) - ecm_optional_add_subdirectory(cursortheme) - ecm_optional_add_subdirectory(fonts) - ecm_optional_add_subdirectory(fontinst) - ecm_optional_add_subdirectory(keys) - ecm_optional_add_subdirectory(keyboard) - ecm_optional_add_subdirectory(mouse) - ecm_optional_add_subdirectory(paths) - ecm_optional_add_subdirectory(kcmsmserver) - ecm_optional_add_subdirectory(cache) - ecm_optional_add_subdirectory(filemanager) - ecm_optional_add_subdirectory(filetypes) - ecm_optional_add_subdirectory(kcmcss) - ecm_optional_add_subdirectory(kcmlaunch) - ecm_optional_add_subdirectory(kcmnotify) - ecm_optional_add_subdirectory(language) - ecm_optional_add_subdirectory(netpref) - ecm_optional_add_subdirectory(performance) - ecm_optional_add_subdirectory(proxy) - ecm_optional_add_subdirectory(spellchecking) - ecm_optional_add_subdirectory(componentchooser) - ecm_optional_add_subdirectory(kded) - ecm_optional_add_subdirectory(history) - ecm_optional_add_subdirectory(solid-device-automounter) - ecm_optional_add_subdirectory(phonon) -endif () +ecm_optional_add_subdirectory(autostart) +ecm_optional_add_subdirectory(bell) +ecm_optional_add_subdirectory(cursortheme) +ecm_optional_add_subdirectory(fonts) +ecm_optional_add_subdirectory(fontinst) +ecm_optional_add_subdirectory(keys) +ecm_optional_add_subdirectory(keyboard) +ecm_optional_add_subdirectory(mouse) +ecm_optional_add_subdirectory(paths) +ecm_optional_add_subdirectory(kcmsmserver) +ecm_optional_add_subdirectory(cache) +ecm_optional_add_subdirectory(filemanager) +ecm_optional_add_subdirectory(filetypes) +ecm_optional_add_subdirectory(kcmcss) +ecm_optional_add_subdirectory(kcmlaunch) +ecm_optional_add_subdirectory(kcmnotify) +ecm_optional_add_subdirectory(translations) +ecm_optional_add_subdirectory(formats) +ecm_optional_add_subdirectory(netpref) +ecm_optional_add_subdirectory(performance) +ecm_optional_add_subdirectory(proxy) +ecm_optional_add_subdirectory(spellchecking) +ecm_optional_add_subdirectory(componentchooser) +ecm_optional_add_subdirectory(kded) +ecm_optional_add_subdirectory(history) +ecm_optional_add_subdirectory(solid-device-automounter) +ecm_optional_add_subdirectory(phonon) if ( NOT Q_WS_WIN ) ecm_optional_add_subdirectory(smb) diff --git a/doc/kcontrol/language/CMakeLists.txt b/doc/kcontrol/formats/CMakeLists.txt similarity index 70% copy from doc/kcontrol/language/CMakeLists.txt copy to doc/kcontrol/formats/CMakeLists.txt index c0fb059..6e61fe5 100644 --- a/doc/kcontrol/language/CMakeLists.txt +++ b/doc/kcontrol/formats/CMakeLists.txt @@ -1,2 +1,2 @@ ########### install files ############### -kdoctools_create_handbook(index.docbook INSTALL_DESTINATION ${HTML_INSTALL_DIR}/en SUBDIR kcontrol/language) +kdoctools_create_handbook(index.docbook INSTALL_DESTINATION ${HTML_INSTALL_DIR}/en SUBDIR kcontrol/formats) diff --git a/doc/kcontrol/formats/index.docbook b/doc/kcontrol/formats/index.docbook new file mode 100644 index 0000000..fc11157 --- /dev/null +++ b/doc/kcontrol/formats/index.docbook @@ -0,0 +1,63 @@ +<?xml version="1.0" ?> +<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" +"dtd/kdedbx45.dtd" [ +<!ENTITY % addindex "IGNORE"> +<!ENTITY % English "INCLUDE" > <!-- change language only here --> +]> + +<article id="formats" lang="&language;"> +<articleinfo> +<title>Formats</title> +<authorgroup> +<author>&Mike.McBride; &Mike.McBride.mail;</author> +<author>&Krishna.Tateneni; &Krishna.Tateneni.mail;</author> +<!-- TRANS:ROLES_OF_TRANSLATORS --> + </authorgroup> + + <date>2015-05-18</date> + <releaseinfo>Plasma 5.3</releaseinfo> + + <keywordset> + <keyword>KDE</keyword> + <keyword>Systemsettings</keyword> + <keyword>locale</keyword> + <keyword>country</keyword> + <keyword>language</keyword> + <keyword>number</keyword> + <keyword>currency</keyword> + </keywordset> +</articleinfo> + +<para> +This module of the &kde; &systemsettings; allows you to select customization +options that depend on the region of the world that you happen to live in. +</para> + +<para> +In most cases, you can simply select the region, and all +options will be set in an appropriate manner. +</para> + +<para> +On the bottom of this module you can see examples how the settings look +like and which measurement units are used. In addition to numbers, you can see +how currency values, dates, and times in lond and short format are displayed. +When you change any of the settings, the preview shows the effects of the +changes before you apply them. +</para> + +<para> +The <guilabel>Region</guilabel> drop down box contains the list of available +countries and will initially show your currently selected country. If the +selection shows <quote>Default</quote> then you have not set a country +and are defaulting to the Country set by the system, which will also be shown. +</para> + +<para> +In case you need different individual settings enable <guilabel>Details Settings</guilabel> +and select the country format for <guilabel>Numbers</guilabel>, <guilabel>Time</guilabel>, +<guilabel>Currency</guilabel>, <guilabel>Measurement Units</guilabel> or +<guilabel>Collation and Sorting</guilabel> rules from the drop down boxes. +</para> + +</article> diff --git a/doc/kcontrol/language/index.docbook b/doc/kcontrol/language/index.docbook deleted file mode 100644 index ea9f4ef..0000000 --- a/doc/kcontrol/language/index.docbook +++ /dev/null @@ -1,633 +0,0 @@ -<?xml version="1.0" ?> -<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" -"dtd/kdedbx45.dtd" [ -<!ENTITY % addindex "IGNORE"> -<!ENTITY % English "INCLUDE" > <!-- change language only here --> -]> - -<article id="language" lang="&language;"> -<articleinfo> -<title>Country/Region & Language</title> -<authorgroup> -<author>&Mike.McBride; &Mike.McBride.mail;</author> -<author>&Krishna.Tateneni; &Krishna.Tateneni.mail;</author> -<!-- TRANS:ROLES_OF_TRANSLATORS --> - </authorgroup> - - <date>2013-12-05</date> - <releaseinfo>4.12</releaseinfo> - - <keywordset> - <keyword>KDE</keyword> - <keyword>Systemsettings</keyword> - <keyword>locale</keyword> - <keyword>country</keyword> - <keyword>language</keyword> - </keywordset> -</articleinfo> - - -<sect1 id="locale"> - -<title>Country/Region & Language</title> - -<para> -This module of the &kde; &systemsettings; allows you to select customization -options that depend on the region of the world that you happen to live in. -There are seven different tabs in this module, each of which is described in -detail in the following sections. -</para> - -<para> -In most cases, you can simply select the country and the language, and the -other options will be set in an appropriate manner. -</para> - -<para> -Below the tabs of this module you can see a preview of what the settings look -like. In addition to positive and negative numbers, you can see how positive -and negative currency values, long and short dates, and times are displayed. -When you change any of the settings, the preview shows the effects of the -changes before you apply them. -</para> - -<para> -Each setting option in the various tabs has an individual <inlinemediaobject> -<imageobject><imagedata fileref="oxygen-22x22-document-revert.png" format="PNG"/> -</imageobject></inlinemediaobject> default button which -is activated whenever that setting is different to your country default value. -Clicking on the button will restore only that setting to your Country default. -</para> - - -<sect2 id="locale-country"> - -<title>Country</title> - -<para> -In this tab you can select the country or region that you want to use. -</para> - -<para> -The <guilabel>Country</guilabel> drop down box contains the list of available -countries and will initially show your currently selected country. If the -selection shows <quote>System Country</quote> then you have not set a country -and are defaulting to the Country set by the system, which will also be shown. -Changing the country will automatically change the settings to the defaults for -that country, except were you have set your own settings which will be left -unchanged. You can easily see where your personal settings differ from the -country settings by looking at the Default button next to the individual -setting. If the button is enabled then your personal setting is different and -you can click on the button to restore the country setting for that option -only. -</para> - -</sect2> - - -<sect2 id="locale-languages"> - -<title>Languages</title> - -<para> -In this tab you can set your preferred languages for the &kde; Workspace and -Applications to be displayed in. -</para> - -<para> -The &kde; Workspace and Applications are written in American English and are -translated into many different languages by teams of volunteers. These -translations need to be installed first before you can choose to use them. The -list of <guilabel>Available Languages</guilabel> shows what KDE translations -are installed and available on your system. If the language you want to use is -not shown in this list then you will need to install it using the usual method -for your system. Your system may have enabled the -<guilabel>Install more languages</guilabel> button to make this easy for you. -</para> - -<para> -The <guilabel>Preferred Languages</guilabel> list shows the languages that will -be used when displaying the &kde; Workspace and Applications. Because not all -of the KDE Workspace and Applications may be translated into every language -&kde; will try to find suitable translations for you by working down the -<guilabel>Preferred Languages</guilabel> list until it finds a translation. If -none of your preferred languages have a required translation then the original -American English will be used. -</para> - -<para> -You can add a language to the <guilabel>Preferred Languages</guilabel> list by -selecting it in the <guilabel>Available Languages</guilabel> and then clicking -on the Add arrow button. You can remove a language from the -<guilabel>Preferred Languages</guilabel> list by selecting it and then clicking -on the Remove arrow button. You can change the order of preference in the -<guilabel>Preferred Languages</guilabel> list by selecting a language and -clicking on the Up or Down arrow button. -</para> - -<para>Only languages listed in <guilabel>Preferred Languages</guilabel> and -<guilabel>Available Languages</guilabel> will be offered as options -for <guilabel>Primary language</guilabel> and <guilabel>Fallback language</guilabel> -in the <guilabel>Switch Application Language</guilabel> dialog of the -<guimenu>Help</guimenu> menu. -</para> - -<note> -<para> -Language and Country/Region are independent settings. Changing a language does -<emphasis>not</emphasis> automatically change the settings for numbers, -currency &etc; to the corresponding country or region. It will only change the -language used in displaying dates, such as month names. -</para> -</note> - -</sect2> - - -<sect2 id="locale-numbers"> - -<title>Numbers</title> - -<para> -On this tab, you can select options for how numbers are displayed. The defaults -are selected automatically based on the country which is currently selected. -</para> - -<para>In the first drop down box you can define the <guilabel>Digit grouping</guilabel> -used to display numbers.</para> - -<para> -In the <guilabel>Group separator</guilabel> text box you can type the character -that you want to use to separate groups of digits in numbers, usually a -<userinput>.</userinput> or a <userinput>,</userinput>. You should ensure that -this value is different to the <guilabel>Decimal separator</guilabel> setting. -The drop-down box provides a list of common values to choose from. -</para> - -<para> -In the <guilabel>Decimal separator</guilabel> text box you can type the -character that you want to use to separate the decimal portion of numbers, -usually a <userinput>.</userinput> or a <userinput>,</userinput>. You should -ensure that this value is different to the <guilabel>Group separator</guilabel> -setting. The drop-down box provides a list of common values to choose from. -</para> - -<para> -In the <guilabel>Decimal places</guilabel> spin box you can set the number of -decimal places displayed for numeric values, &ie; the number of digits -<emphasis>after</emphasis> the decimal separator. -</para> - -<para> -In the <guilabel>Positive sign</guilabel> text box you can type the character -that you want to use to indicate positive numbers. You should ensure that this -value is different to the <guilabel>Negative sign</guilabel> setting. The -drop-down box provides a list of common values to choose from. This value may -also be used for monetary values depending on the -<guilabel>Positive format</guilabel> selected in the <guilabel>Money</guilabel> -tab. -</para> - -<para> -In the <guilabel>Negative sign</guilabel> text box you can type the character -that you want to use to indicate negative numbers. You should ensure that this -value is different to the <guilabel>Positive sign</guilabel> setting. The -drop-down box provides a list of common values to choose from. This value may -also be used for monetary values depending on the -<guilabel>Negative format</guilabel> selected in the <guilabel>Money</guilabel> -tab. -</para> - -<para> -The <guilabel>Digit set</guilabel> drop down box lists digit sets which may be -used instead of Arabic digits when displaying numbers. If you select a digit -set other than Arabic, it will be applied only to numbers which appear in a -language context that uses that digit set while Arabic digits are still going -to be used elsewhere, ⪚ Arabic-Indic digits will be applied to Arabic but -not to American English. -</para> - -<para> -Note that digit grouping, group separator, decimal separator, decimal places, positive format, -negative format and the digit set used to display monetary values has to be set -separately on the <guilabel>Money</guilabel> tab. -</para> - -</sect2> - - -<sect2 id="locale-money"> - -<title>Money</title> - -<para> -On this tab, you can select options for how monetary values are displayed. The -defaults are selected automatically based on the country which is currently -selected. -</para> - -<para> -In the <guilabel>Currency</guilabel> drop-down box you can choose the currency -you want to use when displaying monetary values. This will default to the main -currency in use in your selected country. You can choose a different currency -from the drop-down box, which displays the names of all available currencies -their ISO 4217 standard Currency Code. The currencies used in your selected -country are listed at the top, followed by all the other currencies. Changing -the currency will also update the <guilabel>Currency symbol</guilabel> to use -the default symbol for that currency, but no other format settings will be -changed. -</para> - -<para> -In the <guilabel>Currency symbol</guilabel> drop-down box you can choose the -currency symbol you want to use when displaying monetary values. This will -default to the usual symbol of the currency you have selected in the -<guilabel>Currency</guilabel> drop-down box. This will only allow you to select -a valid currency symbol for the currency code to prevent inconsistent choices, -such as choosing US Dollars but showing the Pound Sterling symbol £ instead. -This setting will automatically be changed when you change the -<guilabel>Currency</guilabel> setting. -</para> - -<para>In the next drop down box you can define the <guilabel>Digit grouping</guilabel> -used to display monetary values.</para> - -<para> -In the <guilabel>Group separator</guilabel> text box you can type the character -that you want to use to separate groups of digits in monetary values, usually a -<userinput>.</userinput> or a <userinput>,</userinput>. You should ensure that -this value is different to the <guilabel>Decimal separator</guilabel> setting. -The drop-down box provides a list of common values to choose from. -</para> - -<para> -In the <guilabel>Decimal separator</guilabel> text box you can type the -character that you want to use to separate the decimal portion of monetary -values, usually a <userinput>.</userinput> or a <userinput>,</userinput>. You -should ensure that this value is different to the -<guilabel>Group separator</guilabel> setting. The drop-down box provides a list -of common values to choose from. -</para> - -<para> -In the <guilabel>Decimal places</guilabel> spin box you can set the number of -decimal places displayed for monetary values, &ie; the number of digits -<emphasis>after</emphasis> the decimal separator. -</para> - -<para> -In the <guilabel>Positive format</guilabel> drop-down box you can select how -you want positive monetary values to be displayed. The drop-down box displays a -list of four sample formats that you can choose from, combining the options for -where the <guilabel>Currency symbol</guilabel> and the numeric value -<guilabel>Positive sign</guilabel> are displayed. You can also choose to -replace the numeric value <guilabel>Positive sign</guilabel> with brackets. -</para> - -<para> -In the <guilabel>Negative format</guilabel> drop-down box you can select how -you want negative monetary values to be displayed. The drop-down box displays a -list of ten sample formats that you can choose from, combining the options for -where the <guilabel>Currency symbol</guilabel> and the numeric value -<guilabel>Negative sign</guilabel> are displayed. You can also choose to -replace the numeric value <guilabel>Negative sign</guilabel> with brackets. -</para> - -<para> -The <guilabel>Digit set</guilabel> drop down box lists digit sets which may be -used instead of Arabic digits when displaying money. If you select a digit -set other than Arabic, it will be applied only to numbers which appear in a -language context that uses that digit set while Arabic digits are still going -to be used elsewhere, ⪚ Arabic-Indic digits will be applied to Arabic but -not to American English. -</para> - -<para> -Note that digit grouping, group separator, decimal separator, decimal places, positive sign, -negative sign and the digit set used to display numeric values has to be set -separately on the <guilabel>Numbers</guilabel> tab. -</para> - -</sect2> - - -<sect2 id="locale-calendar"> - -<title>Calendar</title> - -<para> -On this tab, you can select options for how calendar information is displayed. -The defaults are selected automatically based on the country which is currently -selected. -</para> - -<para> -In the <guilabel>Calendar system</guilabel> drop-down box you can choose the -calendar system to be used when displaying or inputting dates. This will -default to the main calendar system in use in your selected country, usually -the Gregorian calendar. Changing the calendar system will also update the -various weekday name drop-down combos with the names of days of the week in the -new calendar system, will enable or disable the <guilabel>Use Common Era</guilabel> -tick box and may change the value of the <guilabel>Short year window</guilabel> -setting. -</para> - -<para> -Note that the Gregorian calendar used is a hybrid of the Julian calendar up to -Thursday 4 October 1582 and the Gregorian calendar from Friday 15 October 1582, -leaving a <quote>gap</quote> of ten <quote>missing</quote> days. We are aware -this conversion date is not factually correct for all countries, however this -is how Qt have chosen to implement the Gregorian calendar and we wish to remain -consistent with them. -</para> - -<para> -If you have selected the Gregorian calendar system then the <guilabel>Use -Common Era</guilabel> tick box will be enabled. This allows you to choose to -use the Common Era (CE/BCE) instead of the Christian Era (AD/BC) when -displaying and inputting dates. See the <guilabel>Date & Time</guilabel> -tab for how to set this up. -</para> - -<para> -The <guilabel>Short year window</guilabel> option is only used when you choose -to use a short two digit year format (YY) in the <guilabel>Long date -format</guilabel> or <guilabel>Short date format</guilabel> settings in the -<guilabel>Date & Time</guilabel> tab. When inputting a short year value, -⪚ 10, the system must guess what century that year falls in. By setting -the <guilabel>Short year window</guilabel> you tell the system how you want the -short year to be interpreted, ⪚ whether 50 is interpreted as 1950 or 2050. -This window can be set differently for each calendar system as they all use -different epochs (start dates). For example, the Hebrew calendar is into its -58th century (2010 Gregorian is roughly 5771 Hebrew), so may use a window of -5750 to 5850. -</para> - -<para>The <guilabel>Week number system</guilabel> option determines how the -week number will be calculated. There are four options available:</para> -<variablelist> -<varlistentry> -<term><guilabel>ISO Week</guilabel></term> -<listitem><para>Use the ISO standard Week Number. This will always use Monday -as the first day of the ISO week. This is the most commonly used system. -</para></listitem> -</varlistentry> -<varlistentry> -<term><guilabel>Full First Week</guilabel></term> -<listitem><para>The first week of the year starts on the first occurrence -of the <emphasis>First day of the week</emphasis>, and lasts for seven days. -Any days before Week 1 are considered part of the last week of the previous year. -This system is most commonly used in the USA. -</para></listitem> -</varlistentry> -<varlistentry> -<term><guilabel>Partial First Week</guilabel></term> -<listitem><para>The first week -starts on the first day of the year. The second week of the year starts on -the first occurrence of the <emphasis>First day of the week</emphasis>, and -lasts for seven days. The first week may not contain seven days. -</para></listitem> -</varlistentry> -<varlistentry> -<term><guilabel>Simple Week</guilabel></term> -<listitem><para>The first week starts on the first day of the year and lasts -seven days, with all new weeks starting on the same weekday as the first day -of the year.</para></listitem> -</varlistentry> -</variablelist> - -<para> -In the <guilabel>First day of week</guilabel> drop-down box you can choose -which weekday is considered the first day of the week. This value is often -used when displaying calendar tables to determine which day is listed first. -</para> - -<para> -In the <guilabel>First working day of week</guilabel> drop-down box you can -choose which weekday is considered the first working day of the week. This -value is often used when displaying calendar tables to determine when the -weekend is. -</para> - -<para> -In the <guilabel>Last working day of week</guilabel> drop-down box you can -choose which weekday is considered the last working day of the week. This -value is often used when displaying calendar tables to determine when the -weekend is. -</para> - -<para> -In the <guilabel>Week day for special religious observance</guilabel> drop-down -box you can choose which weekday is regularly used for special religious -observances. This value is often used when displaying calendar tables to -<quote>red letter</quote> a certain day. If you do not have any particular -weekday for religious observance then you can choose the -<parameter>None / None in particular</parameter> option. -</para> - -</sect2> - - -<sect2 id="locale-datetime"> - -<title>Date & Time</title> - -<para> -On this tab, you can select options for how date and time values are input or -displayed. The defaults are selected automatically based on the country which -is currently selected. -</para> - -<para> -In the <guilabel>Time format</guilabel> text box you can enter the format that -you want to use to input and display times. The format entered is a combination -of special codes representing time components and literal text used to separate -the time components. The special time component codes are listed below. You can -set the format to any combination of time components you like, but you should -always include at least an hour and minutes portion to allow you to input times -that are not ambiguous. The drop-down box provides a list of common time -formats in your currently selected language to choose from. -</para> - -<itemizedlist> -<listitem><para> -<parameter>HH</parameter> - The hour as a decimal number using a 24-hour clock -(00-23). -</para></listitem> -<listitem><para> -<parameter>hH</parameter> - The hour as a decimal number using a 24-hour clock -(0-23). -</para></listitem> -<listitem><para> -<parameter>PH</parameter> - The hour as a decimal number using a 12-hour clock -(01-12). -</para></listitem> -<listitem><para> -<parameter>pH</parameter> - The hour as a decimal number using a 12-hour clock -(1-12). -</para></listitem> -<listitem><para> -<parameter>MM</parameter> - The minutes as a decimal number (00-59). -</para></listitem> -<listitem><para> -<parameter>SS</parameter> - The seconds as a decimal number (00-59). -</para></listitem> -<listitem><para> -<parameter>AMPM</parameter> - Either 'AM' or 'PM' according to the given time -value. Noon is treated as 'PM' and midnight as 'AM'. You should always include -this code if you are using the 12-hour clock codes <parameter>PH</parameter> or -<parameter>pH</parameter> to prevent ambiguity when entering times. -</para></listitem> -</itemizedlist> - -<para> -In the <guilabel>AM symbol</guilabel> text box you can enter the symbol that -you want to use to input or display for AM when using a 12-hour clock. The -drop-down box provides a list of common symbols for your currently selected -language to choose from. -</para> - -<para> -In the <guilabel>PM symbol</guilabel> text box you can enter the symbol that -you want to use to input or display for PM when using a 12-hour clock. The -drop-down box provides a list of common symbols for your currently selected -language to choose from. -</para> - -<para> -In the <guilabel>Long date format</guilabel> text box you can enter the format -that you want to use to input and display long dates. The format entered is a -combination of special codes representing date components and literal text used -to separate the date components. The special date component codes are listed -below. You can set the format to any combination of date components you like, -but you should always include at least enough components to uniquely identify a -day in the year, ⪚ a month and day, to allow you to input dates that are not -ambiguous. If you don't include a year component then the current year will be -used. The drop-down box provides a list of common date formats in your -currently selected language to choose from. -</para> - -<itemizedlist> -<listitem><para> -<parameter>YYYY</parameter> - The year with century as a decimal number -(0000-9999). -</para></listitem> -<listitem><para> -<parameter>YY</parameter> - The year without century as a decimal number -(00-99). -</para></listitem> -<listitem><para> -<parameter>MM</parameter> - The month as a decimal number (01-12). -</para></listitem> -<listitem><para> -<parameter>mM</parameter> - The month as a decimal number (1-12). -</para></listitem> -<listitem><para> -<parameter>MONTH</parameter> - The full month name. -</para></listitem> -<listitem><para> -<parameter>SHORTMONTH</parameter> - The first three characters of the month -name. -</para></listitem> -<listitem><para> -<parameter>DD</parameter> - The day of month as a decimal number (01-31). -</para></listitem> -<listitem><para> -<parameter>dD</parameter> - The day of month as a decimal number (1-31). -</para></listitem> -<listitem><para> -<parameter>WEEKDAY</parameter> - The full weekday name. -</para></listitem> -<listitem><para> -<parameter>SHORTWEEKDAY</parameter> - The first three characters of the weekday -name. -</para></listitem> -<listitem><para> -<parameter>ERAYEAR</parameter> - The Era Year in local format (⪚ 2000 AD). -</para></listitem> -<listitem><para> -<parameter>SHORTERANAME</parameter> - The short Era Name (⪚ AD). -</para></listitem> -<listitem><para> -<parameter>YEARINERA</parameter> - The Year in Era as a decimal number -(⪚ 2000). -</para></listitem> -<listitem><para> -<parameter>DAYOFYEAR</parameter> - The Day of Year as a decimal number. -</para></listitem> -<listitem><para> -<parameter>ISOWEEK</parameter> - The ISO Week as a decimal number. -</para></listitem> -<listitem><para> -<parameter>DAYOFISOWEEK</parameter> - The Day of the ISO Week as a decimal -number. -</para></listitem> -</itemizedlist> - -<para> -In the <guilabel>Short date format</guilabel> text box you can enter the format -that you want to use to input and display short dates. This is in the same -format as the <guilabel>Long date format</guilabel>, please read that section -for more details. The drop-down box provides a list of common date formats in -your currently selected language to choose from. -</para> - -<para> -The <guilabel>Digit set</guilabel> drop down box lists digit sets which may be -used instead of Arabic digits when displaying dates and times. If you select a -digit set other than Arabic, it will be applied only to numbers which appear in -a language context that uses that digit set while Arabic digits are still going -to be used elsewhere, ⪚ Arabic-Indic digits will be applied to Arabic but -not to American English. -</para> - -</sect2> - - -<sect2 id="locale-other"> - -<title>Other</title> - -<para> -On this tab, you can select how other options are displayed. The defaults are -selected automatically based on the country which is currently selected. -</para> - -<para> -In the <guilabel>Page size</guilabel> drop-down box you can choose the page -size to use as the default for new documents, ⪚ in KWord. Note that this -setting does not affect your default paper size in the print dialog, to set -that you need to use the Printers module of the &kde; &systemsettings;. -</para> - -<para> -In the <guilabel>Measurement system</guilabel> drop-down box you can choose the -measurement system to use, either metric or imperial. -</para> - -<para> -In the <guilabel>Byte size units</guilabel> drop-down box you can choose the -unit system to use when displaying numbers counted in bytes. Traditionally -<quote>kilobytes</quote> meant units of 1024 instead of the metric 1000 for -most but not all byte sizes. To reduce confusion you can choose which system -you prefer. The available unit systems are listed below. -</para> - -<itemizedlist> -<listitem><para> -The <parameter>IEC Units</parameter> standard is always in multiples of 1024. -</para></listitem> -<listitem><para> -The <parameter>Metric Units</parameter> standard is always in multiples of 1000. -</para></listitem> -<listitem><para> -The <parameter>JEDEC Units</parameter> standard uses the traditional units used -in &kde; 3.5 and some other operating systems. -</para></listitem> -</itemizedlist> - -</sect2> - -</sect1> - -</article> diff --git a/doc/kcontrol/language/oxygen-22x22-document-revert.png b/doc/kcontrol/language/oxygen-22x22-document-revert.png deleted file mode 100644 index 75ff210..0000000 Binary files a/doc/kcontrol/language/oxygen-22x22-document-revert.png and /dev/null differ diff --git a/doc/kcontrol/language/CMakeLists.txt b/doc/kcontrol/translations/CMakeLists.txt similarity index 68% rename from doc/kcontrol/language/CMakeLists.txt rename to doc/kcontrol/translations/CMakeLists.txt index c0fb059..d43d52b 100644 --- a/doc/kcontrol/language/CMakeLists.txt +++ b/doc/kcontrol/translations/CMakeLists.txt @@ -1,2 +1,2 @@ ########### install files ############### -kdoctools_create_handbook(index.docbook INSTALL_DESTINATION ${HTML_INSTALL_DIR}/en SUBDIR kcontrol/language) +kdoctools_create_handbook(index.docbook INSTALL_DESTINATION ${HTML_INSTALL_DIR}/en SUBDIR kcontrol/translations) diff --git a/doc/kcontrol/translations/index.docbook b/doc/kcontrol/translations/index.docbook new file mode 100644 index 0000000..a13e8cf --- /dev/null +++ b/doc/kcontrol/translations/index.docbook @@ -0,0 +1,92 @@ +<?xml version="1.0" ?> +<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" +"dtd/kdedbx45.dtd" [ +<!ENTITY % addindex "IGNORE"> +<!ENTITY % English "INCLUDE" > <!-- change language only here --> +]> + +<article id="translations" lang="&language;"> +<articleinfo> +<title>Translations</title> +<authorgroup> +<author>&Mike.McBride; &Mike.McBride.mail;</author> +<author>&Krishna.Tateneni; &Krishna.Tateneni.mail;</author> +<!-- TRANS:ROLES_OF_TRANSLATORS --> + </authorgroup> + + <date>2015-05-18</date> + <releaseinfo>Plasma 5.3</releaseinfo> + + <keywordset> + <keyword>KDE</keyword> + <keyword>Systemsettings</keyword> + <keyword>locale</keyword> + <keyword>country</keyword> + <keyword>language</keyword> + <keyword>translation</keyword> + </keywordset> +</articleinfo> + +<para> +On this page you can set your preferred languages for the &kde; Workspace and +Applications to be displayed in. +</para> + +<para> +The &kde; Workspace and Applications are written in American English and are +translated into many different languages by teams of volunteers. These +translations need to be installed first before you can choose to use them. The +list of <guilabel>Available Languages</guilabel> shows the localized language names of &systemsettings; translations +installed and available on your system. If the language you want to use is +not shown in this list then you will need to install it using the usual method +for your system. +</para> +<note><para>Ensure that you have installed the &kde; language packages or translations for the +languages you want to use.</para> +<para>As &kde; is build upon the &Qt; libraries, you need the &Qt; translations for the selected +languages as well to have a fully localized &GUI;.</para></note> +<!--FIXME +Toooltip in GUI about available languages is wrong as well +--> + +<para> +The <guilabel>Preferred Languages</guilabel> list shows the localized language names that will +be used when displaying the &kde; Workspace and Applications. Because not all +of the KDE Workspace and Applications may be translated into every language +&kde; will try to find suitable translations for you by working down the +<guilabel>Preferred Languages</guilabel> list until it finds a translation. If +none of your preferred languages have a required translation then the original +American English will be used. +</para> + +<para> +You can add a language to the <guilabel>Preferred Languages</guilabel> list by +selecting it in the <guilabel>Available Languages</guilabel> and then clicking +on the Add arrow button. If you have the listbox activated just type the first +letter of your desired language. Type the first letter again to step through all +matching entries in the list. +</para> +<para>You can remove a language from the +<guilabel>Preferred Languages</guilabel> list by selecting it and then clicking +on the Remove arrow button. You can change the order of preference in the +<guilabel>Preferred Languages</guilabel> list by selecting a language and +clicking on the Up or Down arrow button. +</para> + +<para>Only languages listed in <guilabel>Preferred Languages</guilabel> and +<guilabel>Available Languages</guilabel> will be offered as options +for <guilabel>Primary language</guilabel> and <guilabel>Fallback language</guilabel> +in the <guilabel>Switch Application Language</guilabel> dialog of the +<guimenu>Help</guimenu> menu. +<!--FIXME apparently wrong - only previously installed languages ?--> +</para> + +<note> +<para> +Translations and Formats are independent settings. Changing a language does +<emphasis>not</emphasis> automatically change the settings for numbers, +currency &etc; to the corresponding country or region. +</para> +</note> + +</article>
