[kde-doc-english] [plasma-desktop] doc/kcontrol/desktopthemedetails: Update desktopthemedetails kcm docbook to 5.6
Burkhard Lück
lueck at hube-lueck.de
Wed Apr 13 16:57:49 UTC 2016
Git commit 98873732cb0d6fd5d47452e0e5d853e87e7adc5a by Burkhard Lück.
Committed on 13/04/2016 at 16:57.
Pushed by lueck into branch 'master'.
Update desktopthemedetails kcm docbook to 5.6
Remove Info about Details tab and how to configure single components of a theme, feature was removed in 5.6
Add note to inform users about removed feature to avoid confusion for users, see e.g https://forum.kde.org/viewtopic.php?f=17&t=132011
Add link to techbase page with info about themedetails
Add recommended tool
REVIEW:127640
D +- -- doc/kcontrol/desktopthemedetails/customizing.png
M +8 -103 doc/kcontrol/desktopthemedetails/index.docbook
http://commits.kde.org/plasma-desktop/98873732cb0d6fd5d47452e0e5d853e87e7adc5a
diff --git a/doc/kcontrol/desktopthemedetails/customizing.png b/doc/kcontrol/desktopthemedetails/customizing.png
deleted file mode 100644
index 4ac18a1..0000000
Binary files a/doc/kcontrol/desktopthemedetails/customizing.png and /dev/null differ
diff --git a/doc/kcontrol/desktopthemedetails/index.docbook b/doc/kcontrol/desktopthemedetails/index.docbook
index 2cfa55a..9d3964d 100644
--- a/doc/kcontrol/desktopthemedetails/index.docbook
+++ b/doc/kcontrol/desktopthemedetails/index.docbook
@@ -14,8 +14,8 @@
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>
-<date>2015-07-14</date>
-<releaseinfo>Plasma 5.3</releaseinfo>
+<date>2016-04-12</date>
+<releaseinfo>Plasma 5.6</releaseinfo>
<keywordset>
<keyword>KDE</keyword>
@@ -26,113 +26,18 @@
</keywordset>
</articleinfo>
-<variablelist>
+<para>A list of available themes is displayed in this dialog. Select a theme by clicking on an item in the list.</para>
-<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
-with items from other themes or from files.
-</para>
+<note>
+<para>Since &plasma; 5.6 it is no longer possible to edit and customize individual components or items in a theme.</para>
-<para>Desktop theme items consist in panel theme item, kickoff theme item,
-analog clock, ...</para>
+<para>The recommended tools to check, blend and test themes is the &plasma;-sdk package, the Theme Explorer specifically.</para>
-<note><para>
-If you want to change your current theme for a full new theme (for example from
-Breeze to Air) then you can do so in the <guilabel>Theme</guilabel> tab.
-</para></note>
-
-<para>All the available themes will be displayed on top, the current one being highlighted.</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
-corresponding item from another theme, or you may select a file. &plasma;
-desktop theme items are svg files, except for the color scheme which is a &kde;
-color scheme file.
-</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>
-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>
-
-<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
-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>
-</listitem>
-</varlistentry>
-
-<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>
-</listitem>
-</varlistentry>
-
-<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 archive file to which the theme will be
-saved.
-</para>
-</listitem>
-</varlistentry>
-
-</variablelist>
-
-</listitem>
-</varlistentry>
-
-</variablelist>
+<para>For more technical information visit <ulink url="https://techbase.kde.org/Development/Tutorials/Plasma5/ThemeDetails">this page</ulink>.</para>
+</note>
</article>
More information about the kde-doc-english
mailing list