[plasma-desktop] doc/kcontrol/icons: Update icons kcm docbook to 5.13
Burkhard Lück
null at kde.org
Wed Sep 5 18:38:34 BST 2018
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
More information about the kde-doc-english
mailing list