doc: import the desktop theme and icons kcm docbooks

They are imported from plasma-desktop at git commit
668b2f0b254e37197615f1be10197542fc6b1213

doc/kcontrol/CMakeLists.txt

@@ -1,2 +1,4 @@
+ecm_optional_add_subdirectory(desktopthemedetails)
+ecm_optional_add_subdirectory(icons)
 ecm_optional_add_subdirectory(screenlocker)
 ecm_optional_add_subdirectory(translations)

doc/kcontrol/desktopthemedetails/CMakeLists.txt

@@ -0,0 +1,3 @@
+########### install files ###############
+#
+kdoctools_create_handbook(index.docbook INSTALL_DESTINATION ${KDE_INSTALL_DOCBUNDLEDIR}/en SUBDIR kcontrol/desktopthemedetails)

doc/kcontrol/desktopthemedetails/index.docbook

@@ -0,0 +1,134 @@
+<?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">
+]>
+<article id="desktopthemedetails" lang="&language;">
+<articleinfo>
+<title>Plasma Style</title>
+<authorgroup>
+<author>
+<firstname>Andrew</firstname>
+<surname>Lake</surname></author>
+<author>
+  <firstname>Carl</firstname>
+  <surname>Schwan</surname>
+</author>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+
+<date>2019-03-08</date>
+<releaseinfo>Plasma 5.16</releaseinfo>
+
+<keywordset>
+<keyword>KDE</keyword>
+<keyword>System Settings</keyword>
+<keyword>desktop</keyword>
+<keyword>theme</keyword>
+<keyword>plasma</keyword>
+</keywordset>
+</articleinfo>
+
+<para>
+  &plasma; comes with multiple themes. The &plasma; theme defines how the different
+  components of &plasma; are displayed (&eg; Plasmoids, panels, widgets).
+</para>
+
+<para>
+  <screenshot>
+    <screeninfo>Here's a screenshot of the &plasma; theme manager</screeninfo>
+    <mediaobject>
+      <imageobject>
+        <imagedata fileref="main.png" format="PNG" />
+      </imageobject>
+      <textobject>
+        <phrase>Customizing &plasma; theme</phrase>
+      </textobject>
+    </mediaobject>
+  </screenshot>
+</para>
+
+<para>In this module you can:</para>
+<itemizedlist>
+  <listitem><para>install and choose &plasma; themes</para></listitem>
+  <listitem><para>edit &plasma; themes</para></listitem>
+  <listitem><para>remove &plasma; themes</para></listitem>
+</itemizedlist>
+
+<para>
+  If you want to remove a theme, use the <inlinemediaobject><imageobject><imagedata
+  fileref="edit-delete.png" format="PNG"/></imageobject></inlinemediaobject> overlay
+  icon at the bottom right of the theme icon. To undo this action click on the
+  <inlinemediaobject><imageobject><imagedata fileref="edit-undo.png"
+  format="PNG"/></imageobject></inlinemediaobject> icon.
+  If you hit <guibutton>Apply</guibutton> or <guibutton>OK</guibutton> the themes
+  selected for removal are actually deleted, so you cannot undo individual or all
+  deletions.
+</para>
+
+<para>
+  If the plasma-sdk package is installed on your system, a button appears hovering
+  a theme preview and lets you start the <application>Plasma Theme Explorer</application>.
+</para>
+<para>
+  For more technical information visit <ulink
+  url="https://techbase.kde.org/Development/Tutorials/Plasma5/ThemeDetails">this
+  page</ulink>.
+</para>
+
+<variablelist>
+  <varlistentry>
+    <term><guilabel>Get New Plasma Styles...</guilabel></term>
+    <listitem>
+    <para>
+      You need to be connected to the Internet to use it. Clicking on this button will
+      display a dialog where you can choose a new plasma theme. Clicking on
+      <guibutton>Install</guibutton> in the dialog will install the chosen &plasma; theme
+      and after you <guibutton>Close</guibutton> the installer your new theme is
+      immediately available.
+    </para>
+    <para>
+    <screenshot>
+    <screeninfo>Get New Plasma Styles...</screeninfo>
+      <mediaobject>
+        <imageobject>
+          <imagedata fileref="get-new-theme.png" format="PNG"/>
+        </imageobject>
+        <textobject>
+          <phrase>Get New Plasma Styles...</phrase>
+        </textobject>
+      </mediaobject>
+    </screenshot>
+    </para>
+    </listitem>
+  </varlistentry>
+  <varlistentry>
+    <term><guilabel>Install from File...</guilabel></term>
+    <listitem>
+      <para>
+      If you downloaded new themes from the internet, you can use this to browse to the
+        location of those newly downloaded themes. Clicking on this button will bring you the
+        file dialog to point to the &plasma; theme tarball you have on your disk.</para>
+
+      <para>Clicking <guibutton>Open</guibutton> in this dialog will install the theme you
+        pointed to and make it available in the theme list.
+      </para>
+    </listitem>
+  </varlistentry>
+</variablelist>
+
+</article>
+
+<!--
+Local Variables:
+mode: xml
+sgml-minimize-attributes:nil
+sgml-general-insert-case:lower
+sgml-indent-step:0
+sgml-indent-data:nil
+End:
+
+vim:tabstop=2:shiftwidth=2:expandtab
+kate: space-indent on; indent-width 2; tab-width 2; indent-mode none;
+-->

doc/kcontrol/icons/CMakeLists.txt

@@ -0,0 +1,2 @@
+########### install files ###############
+kdoctools_create_handbook(index.docbook INSTALL_DESTINATION ${KDE_INSTALL_DOCBUNDLEDIR}/en SUBDIR kcontrol/icons)

doc/kcontrol/icons/index.docbook

@@ -0,0 +1,134 @@
+<?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="icons" lang="&language;">
+<articleinfo>
+<title>Icons</title>
+<authorgroup>
+<author>&Mike.McBride; &Mike.McBride.mail;</author>
+<author>&Jost.Schenck; &Jost.Schenck.mail;</author>
+<author>&Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail;</author>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+
+<date>2018-12-10</date>
+<releaseinfo>Plasma 5.14</releaseinfo>
+
+<keywordset>
+<keyword>KDE</keyword>
+<keyword>KControl</keyword>
+<keyword>icon</keyword>
+</keywordset>
+</articleinfo>
+
+<para>&plasma; comes with a full set of icons in several sizes. These icons
+are being used all over &plasma;: the desktop, the panel, the &dolphin; file
+manager, in every toolbar of every &plasma; application, etc. The icons
+control module offers you very flexible ways of customizing the way &plasma;
+handles icons.</para>
+
+<para>
+<screenshot>
+<screeninfo>Here's a screenshot of the icon theme manager</screeninfo>
+  <mediaobject>
+    <imageobject>
+      <imagedata fileref="main.png" format="PNG"/>
+    </imageobject>
+    <textobject>
+      <phrase>Customizing &plasma; icons</phrase>
+    </textobject>
+  </mediaobject>
+</screenshot>
+</para>
+
+<para>In this module you can:</para>
+<itemizedlist>
+<listitem><para>install and choose icon themes</para></listitem>
+<listitem><para>choose different icon sizes</para></listitem>
+<listitem><para>remove icon themes</para></listitem>
+</itemizedlist>
+
+<important><para>Please note that some of these settings may depend on
+your selected icon theme. &plasma; comes with several icon themes by default,
+Breeze, Breeze Dark and Oxygen.</para></important>
+
+<para>At the top is a preview of the current theme icons. Most default
+installations will have only a few icon theme available, amongst them the &plasma; default
+Breeze theme. You can also download more from the Internet from 
+<ulink url="https://store.kde.org/">https://store.kde.org/</ulink> or
+install them from a local file.</para>
+
+<para>
+On hover an animated preview shows a random selection, common mime types
+and common folder icons.
+</para>
+
+<para>
+If you want to remove a theme, use the <inlinemediaobject><imageobject><imagedata
+fileref="edit-delete.png" format="PNG"/></imageobject></inlinemediaobject> overlay
+icon at the bottom right of the theme icon. To undo this action click on the
+<inlinemediaobject><imageobject><imagedata fileref="edit-undo.png"
+format="PNG"/></imageobject></inlinemediaobject> icon.
+If you hit <guibutton>Apply</guibutton> or <guibutton>OK</guibutton> the themes
+selected for removal are actually deleted, so you cannot undo individual or all
+deletions.
+</para>
+
+<variablelist>
+<varlistentry><term><guilabel>Configure Icon Sizes</guilabel></term>
+<listitem>
+<para>
+Select one of the components and use the slider to adapt the corresponding size.
+</para>
+<para>
+<screenshot>
+<screeninfo>Configure Icon Sizes</screeninfo>
+  <mediaobject>
+    <imageobject>
+      <imagedata fileref="use-of-icons.png" format="PNG"/>
+    </imageobject>
+    <textobject>
+      <phrase>Configure Icon Sizes</phrase>
+    </textobject>
+  </mediaobject>
+</screenshot>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><guilabel>Get New Icons...</guilabel></term>
+<listitem>
+<para>
+You need to be connected to the Internet to use it. Clicking on this button will display a dialog where you can choose a new icon theme. Clicking on <guibutton>Install</guibutton> in the dialog will install the chosen icon theme and after you <guibutton>Close</guibutton> the installer your new theme is immediately available.
+</para>
+<para>
+<screenshot>
+<screeninfo>Get New Icon Themes</screeninfo>
+  <mediaobject>
+    <imageobject>
+      <imagedata fileref="get-new-theme.png" format="PNG"/>
+    </imageobject>
+    <textobject>
+      <phrase>Get New Icon Themes</phrase>
+    </textobject>
+  </mediaobject>
+</screenshot>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><guilabel>Install from File...</guilabel></term>
+<listitem>
+<para>
+If you downloaded new themes from the internet, you can use this to browse to the
+location of those newly downloaded themes. Clicking on this button will bring you the file dialog to point to the icon theme tarball you have on your disk.</para>
+
+<para>Clicking <guibutton>Open</guibutton> in this dialog will install the theme you pointed to and make it available in the theme list.
+</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+</article>