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
