Git commit 02aa25ecbe402192205bc37c407e21cf3b5c1b0a by Bhushan Shah. Committed on 06/01/2019 at 14:33. Pushed by bshah into branch 'master'.
doc: move translations kcm to plasma-workspace as well at time of moving, index.docbook was at commit, c1b9e8003febb1da46b110ff7a92e5b4e036b732 and plasma-desktop head was at, 6eb2d544c767d49b9dfc3dc8f5f1b5b26912f8ca Removed in commit, ced62362743e113813e5e8d9cc292c88be413875 CCMAIL: Burkhard Lück <[email protected]> M +1 -0 doc/kcontrol/CMakeLists.txt A +2 -0 doc/kcontrol/translations/CMakeLists.txt A +87 -0 doc/kcontrol/translations/index.docbook https://commits.kde.org/plasma-workspace/02aa25ecbe402192205bc37c407e21cf3b5c1b0a diff --git a/doc/kcontrol/CMakeLists.txt b/doc/kcontrol/CMakeLists.txt index 732ccd2c..647c43ab 100644 --- a/doc/kcontrol/CMakeLists.txt +++ b/doc/kcontrol/CMakeLists.txt @@ -1 +1,2 @@ ecm_optional_add_subdirectory(screenlocker) +ecm_optional_add_subdirectory(translations) diff --git a/doc/kcontrol/translations/CMakeLists.txt b/doc/kcontrol/translations/CMakeLists.txt new file mode 100644 index 00000000..f950fdb3 --- /dev/null +++ b/doc/kcontrol/translations/CMakeLists.txt @@ -0,0 +1,2 @@ +########### install files ############### +kdoctools_create_handbook(index.docbook INSTALL_DESTINATION ${KDE_INSTALL_DOCBUNDLEDIR}/en SUBDIR kcontrol/translations) diff --git a/doc/kcontrol/translations/index.docbook b/doc/kcontrol/translations/index.docbook new file mode 100644 index 00000000..377f8c43 --- /dev/null +++ b/doc/kcontrol/translations/index.docbook @@ -0,0 +1,87 @@ +<?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>Language</title> +<authorgroup> +<author>&Mike.McBride; &Mike.McBride.mail;</author> +<author>&Krishna.Tateneni; &Krishna.Tateneni.mail;</author> +<!-- TRANS:ROLES_OF_TRANSLATORS --> + </authorgroup> + + <date>2018-11-28</date> + <releaseinfo>Plasma 5.14</releaseinfo> + + <keywordset> + <keyword>KDE</keyword> + <keyword>Systemsettings</keyword> + <keyword>locale</keyword> + <keyword>country</keyword> + <keyword>language</keyword> + <keyword>translation</keyword> + <keyword>Language</keyword> + </keywordset> +</articleinfo> + +<para> +On this page you can set your preferred languages for the &plasma; Workspace and +Applications to be displayed in. +</para> + +<para> +The &plasma; Workspace and &kde; 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. +</para> +<note><para>Ensure that you have installed the &plasma; language packages or translations for the +languages you want to use.</para> +<para>As &plasma; 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> + +<para> +The list shows the localized language names that will +be used when displaying the &plasma; Workspace and Applications. Because not all +of the &plasma; Workspace and Applications may be translated into every language +&plasma; will try to find suitable translations for you by working down the +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 main list by clicking the <guibutton>Add language</guibutton> +button. +The localized language names of &systemsettings; translations +installed and available on your system are displayed. 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. +Select one or more languages in the list and click <guibutton>Add</guibutton>. +</para> +<para>You can remove a language from the main list by selecting it and then clicking +on the <inlinemediaobject><imageobject><imagedata fileref="list-remove.png" format="PNG"/> +</imageobject></inlinemediaobject> icon. You can change the order of preference in the +list by selecting a language and clicking on the <inlinemediaobject><imageobject> +<imagedata fileref="go-top.png" format="PNG"/> +</imageobject></inlinemediaobject> icon. +</para> + +<para>Only languages with installed &systemsettings; translations 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 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>
