Git commit 6864d6fee4a220e7345329363e8511a4b617baa5 by Burkhard Lück. Committed on 05/09/2018 at 17:37. Pushed by lueck into branch 'master'.
Update icons kcm docbook to 5.13 apply changes from [Icon KCM] Port to new design https://phabricator.kde.org/D12459 Differential Revision: https://phabricator.kde.org/D15024 D +- -- doc/kcontrol/icons/delete-theme.png A +- -- doc/kcontrol/icons/edit-delete.png A +- -- doc/kcontrol/icons/edit-undo.png D +- -- doc/kcontrol/icons/effects.png M +36 -237 doc/kcontrol/icons/index.docbook D +- -- doc/kcontrol/icons/install-theme.png M +- -- doc/kcontrol/icons/main.png D +- -- doc/kcontrol/icons/size.png M +- -- doc/kcontrol/icons/use-of-icons.png https://commits.kde.org/plasma-desktop/6864d6fee4a220e7345329363e8511a4b617baa5 diff --git a/doc/kcontrol/icons/delete-theme.png b/doc/kcontrol/icons/delete-theme.png deleted file mode 100644 index 2009c14b..00000000 Binary files a/doc/kcontrol/icons/delete-theme.png and /dev/null differ diff --git a/doc/kcontrol/icons/edit-delete.png b/doc/kcontrol/icons/edit-delete.png new file mode 100644 index 00000000..9be3fb20 Binary files /dev/null and b/doc/kcontrol/icons/edit-delete.png differ diff --git a/doc/kcontrol/icons/edit-undo.png b/doc/kcontrol/icons/edit-undo.png new file mode 100644 index 00000000..6080e7de Binary files /dev/null and b/doc/kcontrol/icons/edit-undo.png differ diff --git a/doc/kcontrol/icons/effects.png b/doc/kcontrol/icons/effects.png deleted file mode 100644 index 73e1f4ec..00000000 Binary files a/doc/kcontrol/icons/effects.png and /dev/null differ diff --git a/doc/kcontrol/icons/index.docbook b/doc/kcontrol/icons/index.docbook index 942c4331..1b1ccc03 100644 --- a/doc/kcontrol/icons/index.docbook +++ b/doc/kcontrol/icons/index.docbook @@ -15,8 +15,8 @@ <!-- TRANS:ROLES_OF_TRANSLATORS --> </authorgroup> -<date>2017-11-07</date> -<releaseinfo>Plasma 5.11</releaseinfo> +<date>2018-08-21</date> +<releaseinfo>Plasma 5.13</releaseinfo> <keywordset> <keyword>KDE</keyword> @@ -24,17 +24,12 @@ <keyword>icon</keyword> </keywordset> </articleinfo> -<sect1 id="kcm_icons"> -<title>Icons</title> - -<sect2 id="icons-intro"> -<title>Introduction</title> <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> +handles icons.</para> <para> <screenshot> @@ -54,282 +49,86 @@ handles icons. </para> <itemizedlist> <listitem><para>install and choose icon themes</para></listitem> <listitem><para>choose different icon sizes</para></listitem> -<listitem><para>assign effects to icons (for example make them -semi-transparent or colorize them) </para></listitem> -<listitem><para>configure these settings for each of the different places -icons will be used in: for example the desktop, toolbars &etc; -</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, -Oxygen, Monochrome and Breeze.</para></important> - -<para>There are two pages in this module: <guilabel>Theme</guilabel> and <guilabel>Advanced</guilabel>. <guilabel>Theme</guilabel> manages the icon themes while <guilabel>Advanced</guilabel> lets you configure how icons will be used in &plasma;.</para> -</sect2> - -<sect2 id="icon-theme"> -<title>Theme</title> +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>.</para> +<ulink url="https://store.kde.org/">https://store.kde.org/</ulink> or +install a them from a local file.</para> -<variablelist> -<varlistentry><term><guilabel>Get New 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 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. +On hover an animated preview shows a random selection, common mime types +and common folder icons. </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> +If you want to remove a theme, use the <inlinemediaobject><imageobject><imagedata +fileref="edit-delete.png" format="PNG"/></imageobject></inlinemediaobject> overlay +icon at the button 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 can undo individual or all +deletions </para> -</listitem> -</varlistentry> -<varlistentry><term><guilabel>Install Theme File...</guilabel></term> + +<variablelist> +<varlistentry><term><guilabel>Configure Icon Sizes</guilabel></term> <listitem> <para> -If you dowloaded 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 a small dialog to point to the icon theme tarball you have on your disk.</para> +Select one of the components and use the slider to adapt the corresponding size. +</para> <para> <screenshot> -<screeninfo>Installing A New Icon Theme</screeninfo> +<screeninfo>Configure Icon Sizes</screeninfo> <mediaobject> <imageobject> - <imagedata fileref="install-theme.png" format="PNG"/> + <imagedata fileref="use-of-icons.png" format="PNG"/> </imageobject> <textobject> - <phrase>Installing A New Icon Theme</phrase> + <phrase>Configure Icon Sizes</phrase> </textobject> </mediaobject> </screenshot> </para> -<para>Clicking <guibutton>OK</guibutton> in this dialog will install the theme you pointed to and make it available in the theme list. -</para> </listitem> </varlistentry> -<varlistentry><term><guilabel>Remove Theme</guilabel></term> +<varlistentry><term><guilabel>Get New Themes...</guilabel></term> <listitem> <para> -Clicking this button will remove all files for this theme from your system. A confirmation message is displayed and will ask you if you are really sure you want to remove all the files for this theme. +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>Removing A Theme</screeninfo> +<screeninfo>Get New Icon Themes</screeninfo> <mediaobject> <imageobject> - <imagedata fileref="delete-theme.png" format="PNG"/> + <imagedata fileref="get-new-theme.png" format="PNG"/> </imageobject> <textobject> - <phrase>Removing A Theme</phrase> + <phrase>Get New Icon Themes</phrase> </textobject> </mediaobject> </screenshot> </para> -<para>Clicking <guibutton>Delete</guibutton> will remove the theme files and clicking <guibutton>Cancel</guibutton> will not delete anything and will cancel the remove action. -</para> </listitem> </varlistentry> -</variablelist> - -</sect2> - -<sect2 id="icons-use"> -<title>Advanced</title> - -<para>Looking at this second page of the icons control module, you -will see two areas:</para> - -<itemizedlist> -<listitem> -<para>An area labelled <guilabel>Use of Icon</guilabel>. Here you can -choose which particular usage of icons you want to configure, for -example <guilabel>Toolbar</guilabel> or <guilabel>Panel</guilabel>. -</para> -<para> -<screenshot> -<screeninfo>Choosing the icons to configure</screeninfo> - <mediaobject> - <imageobject> - <imagedata fileref="use-of-icons.png" format="PNG"/> - </imageobject> - <textobject> - <phrase>Choosing the icons to configure</phrase> - </textobject> - </mediaobject> -</screenshot> -</para> -</listitem> - -<listitem> <para>A preview area where you can see how -icons of the selected kind will look using the current -settings. Note that the state of this preview also depends on the icon -state selected in the effects below (do not worry -about that now, we will explain that below). </para> </listitem> -</itemizedlist> - -<para>When you want to configure icons, first select the usage of icons -you want to configure. Change the settings until you like the -preview. You can then choose a different icon usage and configure -that. At the end, if you are satisfied with your settings, click -<guibutton>OK</guibutton> or <guibutton>Apply</guibutton> to take the -changes in effect.</para> - -<para>There are two further options to consider, -<guilabel>Size</guilabel> and <guilabel>Effects</guilabel>. </para> - -<sect3 id="icons-use-size"> -<title>Icon Size</title> - +<varlistentry><term><guilabel>Install from File...</guilabel></term> +<listitem> <para> -<screenshot> -<screeninfo>Setting icons sizes</screeninfo> - <mediaobject> - <imageobject> - <imagedata fileref="size.png" format="PNG"/> - </imageobject> - <textobject> - <phrase>Setting icons sizes</phrase> - </textobject> - </mediaobject> -</screenshot> -</para> - -<para>You can choose -from a list of icon sizes. The largest icon sizes are especially useful -for visually impaired people.</para> - -<para>Which sizes will be offered by the icon size listbox depends on -the icon theme you have selected in the icon themes control module. For -example, the low color icon theme only offers the sizes 16 and 32 for -desktop icons and 16, 22 and 32 for toolbar icons. The HiColor theme -offers icon sizes 16, 32 and 48 as well as sizes from 64 to 128. -However, as &plasma; can not have all these icon sizes in store, icons -using size 64 to 128 will be automatically generated which may result in -a loss of quality.</para> - -<para>You can also choose animated icons. Many of the icons have -animations associated with them. Enable the checkbox labelled -<guilabel>Enable icon animations</guilabel>, to enable this effect, but note -that it may appear slow or jerky if your graphics card is old or you -are low on memory.</para> - -</sect3> +If you dowloaded 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> -<sect3 id="icons-use-effects"> -<title>Effects</title> -<para> -<screenshot> -<screeninfo>Setting icons effects</screeninfo> - <mediaobject> - <imageobject> - <imagedata fileref="effects.png" format="PNG"/> - </imageobject> - <textobject> - <phrase>Setting icons effects</phrase> - </textobject> - </mediaobject> -</screenshot> +<para>Clicking <guibutton>Open</guibutton> in this dialog will install the theme you pointed to and make it available in the theme list. </para> - -<para>Finally you can configure certain <quote>filters</quote> to be -applied on icons which are in one of three states:</para> - -<variablelist> -<varlistentry> -<term><guilabel>Default</guilabel></term> -<listitem><para>This is how the icon will look normally.</para></listitem> -</varlistentry> -<varlistentry> -<term><guilabel>Active</guilabel>:</term> -<listitem><para>This is how the icon will look when the mouse cursor is over the icon.</para></listitem> -</varlistentry> -<varlistentry> -<term><guilabel>Disabled</guilabel>:</term> -<listitem><para>This is how the icon will look if its corresponding action is -disabled, &ie; clicking on it will not lead to any -result.</para></listitem> -</varlistentry> -</variablelist> - -<para>Select one of these states, and press the <guibutton>Set -Effect...</guibutton> button to configure a corresponding icon effect. -Please note that this configuration will only affect icons of the -currently selected <guilabel>Use of Icon</guilabel> category (see -above): configuring an effect for active icons, while -<guilabel>Toolbar</guilabel> icon usage is selected, will -<emphasis>not</emphasis> affect active icons used in other -places.</para> - -<para>Below the list of icon states there are two options: you can -configure an effect and you can select the -<guilabel>Semi-transparent</guilabel> option, which will make the -background <quote>shine through</quote> the icon. To the right of the -effects list box there is a slider button to pass additional parameters to -a filter for colours and <guilabel>Amount</guilabel>.</para> -<!-- TODO: Figure out what 'amount' really means --> - -<para>The following effects can be applied to icons:</para> - -<variablelist> -<varlistentry> -<term><guilabel>No Effect</guilabel>:</term> -<listitem><para>Icons will be used without applying any -effect.</para></listitem> -</varlistentry> -<varlistentry> -<term><guilabel>To Gray</guilabel>:</term> -<listitem><para>This filter will apply a grayish look to the icon. Use the -<guilabel>Amount</guilabel> slider to configure the intensity of this filter. Note -that it is customary for most user interfaces to use this effect for disabled -icons only.</para></listitem> -</varlistentry> -<varlistentry> -<term><guilabel>Colorize</guilabel>:</term> -<listitem><para>Icons will be colorized using a custom color. For example, you -may configure active icons (&ie; the icon the mouse cursor is over) to -shine golden. Use the color buttons and the <guilabel>Amount</guilabel> slider -to configure the used color and the intensity of the colorization.</para></listitem> -</varlistentry> -<varlistentry> -<term><guilabel>Gamma</guilabel>:</term> -<listitem><para>A different gamma value will be applied to all icons. If you're -no photographer and don't know what Gamma is: it's quite similar to what people -call contrast. Just play around with the gamma settings by moving the -<guilabel>Amount</guilabel> slider to get a feeling for this -effect.</para></listitem> -</varlistentry> -<varlistentry> -<term><guilabel>Desaturate</guilabel>:</term> -<listitem><para>Icons will be drawn desaturated. This is quite similar to the -<quote>Color</quote> setting on your television. Use the slider to configure -the amount of desaturation. -</para></listitem> -</varlistentry> -<varlistentry> -<term><guilabel>To Monochrome:</guilabel></term> -<listitem> -<para>Icons will be drawn using only the two colours selected.</para> </listitem> </varlistentry> - </variablelist> -</sect3> - -</sect2> - -</sect1> - </article> diff --git a/doc/kcontrol/icons/install-theme.png b/doc/kcontrol/icons/install-theme.png deleted file mode 100644 index f95c79ea..00000000 Binary files a/doc/kcontrol/icons/install-theme.png and /dev/null differ diff --git a/doc/kcontrol/icons/main.png b/doc/kcontrol/icons/main.png index c8038c05..bbccb2df 100644 Binary files a/doc/kcontrol/icons/main.png and b/doc/kcontrol/icons/main.png differ diff --git a/doc/kcontrol/icons/size.png b/doc/kcontrol/icons/size.png deleted file mode 100644 index 68e8918f..00000000 Binary files a/doc/kcontrol/icons/size.png and /dev/null differ diff --git a/doc/kcontrol/icons/use-of-icons.png b/doc/kcontrol/icons/use-of-icons.png index c4595181..5463a6d9 100644 Binary files a/doc/kcontrol/icons/use-of-icons.png and b/doc/kcontrol/icons/use-of-icons.png differ