[plasma-workspace] doc/kcontrol: doc: move translations kcm to plasma-workspace as well

[Bhushan Shah]

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 <lueck at hube-lueck.de>

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>