[plasma-desktop] doc/kcontrol/desktopthemedetails: Update documentation for kcontrol desktop theme (now plasma theme)
Carl Schwan
null at kde.org
Fri Mar 8 17:40:08 GMT 2019
Git commit 245677bfb31a9e54956e51b44f67be098bf1372f by Carl Schwan.
Committed on 08/03/2019 at 17:38.
Pushed by carlschwan into branch 'master'.
Update documentation for kcontrol desktop theme (now plasma theme)
Summary: Some part were copied from kcontrol icons. Need proofreading
Test Plan: checkxml index.docbook and meinproc5 index.docbook
Reviewers: #documentation, yurchor
Reviewed By: #documentation, yurchor
Subscribers: yurchor, plasma-devel, kde-doc-english
Tags: #plasma, #documentation
Differential Revision: https://phabricator.kde.org/D19618
A +- -- doc/kcontrol/desktopthemedetails/edit-delete.png
A +- -- doc/kcontrol/desktopthemedetails/edit-undo.png
A +- -- doc/kcontrol/desktopthemedetails/get-new-theme.png
M +88 -16 doc/kcontrol/desktopthemedetails/index.docbook
A +- -- doc/kcontrol/desktopthemedetails/main.png
https://commits.kde.org/plasma-desktop/245677bfb31a9e54956e51b44f67be098bf1372f
diff --git a/doc/kcontrol/desktopthemedetails/edit-delete.png b/doc/kcontrol/desktopthemedetails/edit-delete.png
new file mode 100644
index 00000000..9be3fb20
Binary files /dev/null and b/doc/kcontrol/desktopthemedetails/edit-delete.png differ
diff --git a/doc/kcontrol/desktopthemedetails/edit-undo.png b/doc/kcontrol/desktopthemedetails/edit-undo.png
new file mode 100644
index 00000000..6080e7de
Binary files /dev/null and b/doc/kcontrol/desktopthemedetails/edit-undo.png differ
diff --git a/doc/kcontrol/desktopthemedetails/get-new-theme.png b/doc/kcontrol/desktopthemedetails/get-new-theme.png
new file mode 100644
index 00000000..2328b170
Binary files /dev/null and b/doc/kcontrol/desktopthemedetails/get-new-theme.png differ
diff --git a/doc/kcontrol/desktopthemedetails/index.docbook b/doc/kcontrol/desktopthemedetails/index.docbook
index 6aef47a0..a814d4df 100644
--- a/doc/kcontrol/desktopthemedetails/index.docbook
+++ b/doc/kcontrol/desktopthemedetails/index.docbook
@@ -6,16 +6,20 @@
]>
<article id="desktopthemedetails" lang="&language;">
<articleinfo>
-<title>Desktop Theme</title>
+<title>Plasma Theme</title>
<authorgroup>
<author>
<firstname>Andrew</firstname>
<surname>Lake</surname></author>
+<author>
+ <firstname>Carl</firstname>
+ <surname>Schwan</surname>
+</author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>
-<date>2018-03-25</date>
-<releaseinfo>Plasma 5.12</releaseinfo>
+<date>2019-03-8</date>
+<releaseinfo>Plasma 5.16</releaseinfo>
<keywordset>
<keyword>KDE</keyword>
@@ -26,25 +30,93 @@
</keywordset>
</articleinfo>
-<para>A preview of available themes is displayed in this dialog. Select a theme by clicking on it.</para>
-
-<para>Use the <guibutton>Get New Desktop Themes...</guibutton> button to download additional themes from the Internet
-or load a theme from file.</para>
+<para>
+ &plasma; comes with multiple themes. The &plasma; theme defines how the different
+ components of &plasma; are displayed (⪚ Plasmoids, panels, widgets).
+</para>
-<para>The <guibutton>Remove</guibutton> button is enabled only for custom themes.</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>
-<note>
-<para>Since &plasma; 5.6 it is no longer possible to edit and customize individual components or items in a theme.</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>The recommended tools to check, blend and test themes is the plasma-sdk package, the <application>
-Plasma Theme Explorer</application> specifically.</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>
-<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>
+ 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>
-<para>For more technical information visit <ulink url="https://techbase.kde.org/Development/Tutorials/Plasma5/ThemeDetails">this page</ulink>.</para>
-</note>
+<variablelist>
+ <varlistentry>
+ <term><guilabel>Get New Plasma Themes...</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 Themes...</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="get-new-theme.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>Get New Plasma 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 &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>
diff --git a/doc/kcontrol/desktopthemedetails/main.png b/doc/kcontrol/desktopthemedetails/main.png
new file mode 100644
index 00000000..fbd99698
Binary files /dev/null and b/doc/kcontrol/desktopthemedetails/main.png differ
More information about the kde-doc-english
mailing list