[kde-doc-english] [plasma-desktop] doc/kcontrol/desktopthemedetails: Update desktopthemedetails kcm docbook to Plasma 5

Tue Jul 21 10:14:26 UTC 2015

Git commit e14a0e6a80b4c9b8f0f129d411a2aefd8dcce73b by Burkhard Lück.
Committed on 21/07/2015 at 10:13.
Pushed by lueck into branch 'master'.

Update desktopthemedetails kcm docbook to Plasma 5
REVIEW:124347

D  +-    --    doc/kcontrol/desktopthemedetails/clicking-apply.png
M  +-    --    doc/kcontrol/desktopthemedetails/customizing.png
M  +44   -76   doc/kcontrol/desktopthemedetails/index.docbook

http://commits.kde.org/plasma-desktop/e14a0e6a80b4c9b8f0f129d411a2aefd8dcce73b

diff --git a/doc/kcontrol/desktopthemedetails/clicking-apply.png b/doc/kcontrol/desktopthemedetails/clicking-apply.png
deleted file mode 100644
index f57723b..0000000
Binary files a/doc/kcontrol/desktopthemedetails/clicking-apply.png and /dev/null differ
diff --git a/doc/kcontrol/desktopthemedetails/customizing.png b/doc/kcontrol/desktopthemedetails/customizing.png
index a16743f..4ac18a1 100644
Binary files a/doc/kcontrol/desktopthemedetails/customizing.png and b/doc/kcontrol/desktopthemedetails/customizing.png differ
diff --git a/doc/kcontrol/desktopthemedetails/index.docbook b/doc/kcontrol/desktopthemedetails/index.docbook
index 19882ed..6120003 100644
--- a/doc/kcontrol/desktopthemedetails/index.docbook
+++ b/doc/kcontrol/desktopthemedetails/index.docbook
@@ -14,8 +14,8 @@
 <!-- TRANS:ROLES_OF_TRANSLATORS -->
 </authorgroup>
 
-<date>2013-06-02</date>
-<releaseinfo>&kde; 4.11</releaseinfo>
+<date>2015-07-14</date>
+<releaseinfo>Plasma 5.3</releaseinfo>
 
 <keywordset>
 <keyword>KDE</keyword>
@@ -26,19 +26,18 @@
 </keywordset>
 </articleinfo>
 
-<sect1 id="kcm_desktoptheme">
-<title>Theme tab</title>
- 
-<para>A list of available themes is displayed on this tab. Select a theme by clicking on an item in the list.</para>
-
-<para>Use the <guibutton>Get New Themes</guibutton> button to launch the <guilabel>Get Hot New Stuff</guilabel> dialog and 
-download additional themes from the Internet.</para>
-
-</sect1>
+<variablelist>
 
-<sect1 id="kcm_desktopthemedetails">
-<title>Details tab</title>
+<varlistentry><term><guilabel>Theme</guilabel> tab</term>
+<listitem>
+<para>A list of available themes is displayed on this tab. Select a theme by clicking on an item in the list.</para>
+<para>Use the <guibutton>Get New Themes</guibutton> button to download additional themes from the Internet
+or load a theme from file.</para>
+</listitem>
+</varlistentry>
 
+<varlistentry><term><guilabel>Details</guilabel> tab</term>
+<listitem>
 <para>A &kde; plasma desktop theme is made up of several components or items,
 consisting mostly in svg backgrounds and colors schemes. This module allows you
 to customize your desktop Plasma theme and to replace theme items 
@@ -50,52 +49,11 @@ analog clock, ...</para>
 
 <note><para>
 If you want to change your current theme for a full new theme (for example from
-Air to Glassified) then you can do so in the <guilabel>Theme</guilabel> tab.
+Breeze to Air) then you can do so in the <guilabel>Theme</guilabel> tab.
 </para></note>
 
-<sect2 id="start">
-<title>Quick start</title>
-<para>First download one or several themes you want to use to customize your 
-desktop items by clicking the <guibutton>Get New Themes...</guibutton>
-button in the <guilabel>Theme</guilabel> tab.</para>
-
 <para>All the available themes will be displayed on top, the current one being highlighted.</para>
 
-<para>In the theme list, select a base theme that will be used for most widgets and start
-customizing each item you want to change with a new theme, for example you can
-have the panel in Glassified theme, the widget
-backgrounds in Air and so on.</para>
-
-<para>Here Air is the theme for most widgets and we changed the panel background
-to Glassified, the Analog clock to Glassified and the Notes to Oxygen.</para>
-
-<para>
-<screenshot>
-<screeninfo>Customizing your plasma theme</screeninfo>
-  <mediaobject>
-    <imageobject>
-      <imagedata fileref="customizing.png" format="PNG"/>
-    </imageobject>
-    <textobject>
-      <phrase>Customizing your plasma theme</phrase>
-    </textobject>
-  </mediaobject>
-</screenshot>
-</para>
-
-<para>
-Clicking the <guibutton>Apply</guibutton> will create a new theme named
-<guilabel>(Customized)</guilabel> and will apply it to your desktop.
-</para>
-</sect2>
-
-<sect2 id="custom">
-<title>Creating a custom theme</title>
-<para>When the module is opened, it will show items from the current desktop
-theme. If you would like to start customizing with a different theme, select it
-from the box above the list of theme items. This theme from the box is the
-starting theme, the base for your new customized desktop theme.</para>
-
 <para>
 In the list of items, for each item you would like to replace, select 
 replacement item from the drop list for that item.  You may select the 
@@ -105,35 +63,35 @@ color scheme file.
 </para>
 
 <para>
-Click <guibutton>Apply</guibutton> when all the changes have been made.  This
-will create a new theme named <guilabel>(Customized)</guilabel> which you can
-select from the Appearance Settings dialog on the desktop.
-</para>
-
-<para>
 <screenshot>
-<screeninfo>Your custom theme</screeninfo>
+<screeninfo>Customizing your plasma theme</screeninfo>
   <mediaobject>
     <imageobject>
-      <imagedata fileref="clicking-apply.png" format="PNG"/>
+      <imagedata fileref="customizing.png" format="PNG"/>
     </imageobject>
     <textobject>
-      <phrase>Customized</phrase>
+      <phrase>Customizing your plasma theme</phrase>
     </textobject>
   </mediaobject>
 </screenshot>
 </para>
 
+<para>
+Click <guibutton>Apply</guibutton> when all the changes have been made. This
+will create a new theme named <guilabel>(Customized)</guilabel> and will 
+apply it to your desktop.
+</para>
+
 <note><para>
 The theme items listed are the most visible components of the plasma 
 desktop theme.  Other theme components are not listed.  Your newly created 
 theme will use these unlisted components from the theme that you  selected at 
 the start of creating the customized theme.
 </para></note>
-</sect2>
 
-<sect2 id="naming">
-<title>Naming a custom theme</title>
+<variablelist>
+<varlistentry><term>Naming a custom theme</term>
+<listitem>
 <para>
 To provide a name for your customized theme, click on the
 <guilabel>More</guilabel> checkbox and 
@@ -141,31 +99,41 @@ enter the name of the theme.  You may also provide your name (author), a theme
 version and a description of your theme.  Click <guibutton>Apply</guibutton>
 when done.
 </para>
-</sect2>
+</listitem>
+</varlistentry>
 
-<sect2 id="removing">
-<title>Removing a theme</title>
+<varlistentry><term>Removing a theme</term>
+<listitem>
 <para>
 Select the theme you would like to remove from the box above the list of 
 theme items. Click on the <guilabel>More</guilabel> check box. Click the
 <guibutton>Remove Theme</guibutton> button to 
 remove the selected theme.
 </para>
-</sect2>
+</listitem>
+</varlistentry>
 
-<sect2 id="exporting">
-<title>Exporting a theme to a file</title>
+<varlistentry><term>Exporting a theme to a file</term>
+<listitem>
+<para>Exporting a theme to a file</para>
 <para>
 You can share your newly customized theme with the community by exporting the 
 theme to a file. Select your customized theme from the box above the list 
 of theme items.  Click on the <guilabel>More</guilabel> check box.  Click the
 <guibutton>Export Theme to 
-File...</guibutton>.  Enter the name of the zip file to which the theme will be
+File...</guibutton>.  Enter the name of the archiv file to which the theme will be
 saved.
 </para>
-</sect2>
+</listitem>
+</varlistentry>
+
+</variablelist>
+
+</listitem>
+</varlistentry>
+
+</variablelist>
 
-</sect1>
 </article>
 
 <!--
