diff --git a/doc/kcontrol/CMakeLists.txt b/doc/kcontrol/CMakeLists.txt index 647c43ab4..b69e9b4ff 100644 --- a/doc/kcontrol/CMakeLists.txt +++ b/doc/kcontrol/CMakeLists.txt @@ -1,2 +1,4 @@ +ecm_optional_add_subdirectory(desktopthemedetails) +ecm_optional_add_subdirectory(icons) ecm_optional_add_subdirectory(screenlocker) ecm_optional_add_subdirectory(translations) diff --git a/doc/kcontrol/desktopthemedetails/CMakeLists.txt b/doc/kcontrol/desktopthemedetails/CMakeLists.txt new file mode 100644 index 000000000..862514e80 --- /dev/null +++ b/doc/kcontrol/desktopthemedetails/CMakeLists.txt @@ -0,0 +1,3 @@ +########### install files ############### +# +kdoctools_create_handbook(index.docbook INSTALL_DESTINATION ${KDE_INSTALL_DOCBUNDLEDIR}/en SUBDIR kcontrol/desktopthemedetails) diff --git a/doc/kcontrol/desktopthemedetails/edit-delete.png b/doc/kcontrol/desktopthemedetails/edit-delete.png new file mode 100644 index 000000000..9be3fb20f 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 000000000..6080e7de9 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 000000000..2328b1700 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 new file mode 100644 index 000000000..a38243cf1 --- /dev/null +++ b/doc/kcontrol/desktopthemedetails/index.docbook @@ -0,0 +1,134 @@ + + + +]> +
+ +Plasma Style + + +Andrew +Lake + + Carl + Schwan + + + + +2019-03-08 +Plasma 5.16 + + +KDE +System Settings +desktop +theme +plasma + + + + + &plasma; comes with multiple themes. The &plasma; theme defines how the different + components of &plasma; are displayed (⪚ Plasmoids, panels, widgets). + + + + + Here's a screenshot of the &plasma; theme manager + + + + + + Customizing &plasma; theme + + + + + +In this module you can: + + install and choose &plasma; themes + edit &plasma; themes + remove &plasma; themes + + + + If you want to remove a theme, use the overlay + icon at the bottom right of the theme icon. To undo this action click on the + icon. + If you hit Apply or OK the themes + selected for removal are actually deleted, so you cannot undo individual or all + deletions. + + + + If the plasma-sdk package is installed on your system, a button appears hovering + a theme preview and lets you start the Plasma Theme Explorer. + + + For more technical information visit this + page. + + + + + Get New Plasma Styles... + + + 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 + Install in the dialog will install the chosen &plasma; theme + and after you Close the installer your new theme is + immediately available. + + + + Get New Plasma Styles... + + + + + + Get New Plasma Styles... + + + + + + + + Install from File... + + + 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. + + Clicking Open in this dialog will install the theme you + pointed to and make it available in the theme list. + + + + + +
+ + diff --git a/doc/kcontrol/desktopthemedetails/main.png b/doc/kcontrol/desktopthemedetails/main.png new file mode 100644 index 000000000..fbd99698a Binary files /dev/null and b/doc/kcontrol/desktopthemedetails/main.png differ diff --git a/doc/kcontrol/icons/CMakeLists.txt b/doc/kcontrol/icons/CMakeLists.txt new file mode 100644 index 000000000..ef088d054 --- /dev/null +++ b/doc/kcontrol/icons/CMakeLists.txt @@ -0,0 +1,2 @@ +########### install files ############### +kdoctools_create_handbook(index.docbook INSTALL_DESTINATION ${KDE_INSTALL_DOCBUNDLEDIR}/en SUBDIR kcontrol/icons) diff --git a/doc/kcontrol/icons/edit-delete.png b/doc/kcontrol/icons/edit-delete.png new file mode 100644 index 000000000..9be3fb20f 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 000000000..6080e7de9 Binary files /dev/null and b/doc/kcontrol/icons/edit-undo.png differ diff --git a/doc/kcontrol/icons/get-new-theme.png b/doc/kcontrol/icons/get-new-theme.png new file mode 100644 index 000000000..2b46cf7d9 Binary files /dev/null and b/doc/kcontrol/icons/get-new-theme.png differ diff --git a/doc/kcontrol/icons/index.docbook b/doc/kcontrol/icons/index.docbook new file mode 100644 index 000000000..6d1516e46 --- /dev/null +++ b/doc/kcontrol/icons/index.docbook @@ -0,0 +1,134 @@ + + + +]> + +
+ +Icons + +&Mike.McBride; &Mike.McBride.mail; +&Jost.Schenck; &Jost.Schenck.mail; +&Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail; + + + +2018-12-10 +Plasma 5.14 + + +KDE +KControl +icon + + + +&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. + + + +Here's a screenshot of the icon theme manager + + + + + + Customizing &plasma; icons + + + + + +In this module you can: + +install and choose icon themes +choose different icon sizes +remove icon themes + + +Please note that some of these settings may depend on +your selected icon theme. &plasma; comes with several icon themes by default, +Breeze, Breeze Dark and Oxygen. + +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 +https://store.kde.org/ or +install them from a local file. + + +On hover an animated preview shows a random selection, common mime types +and common folder icons. + + + +If you want to remove a theme, use the overlay +icon at the bottom right of the theme icon. To undo this action click on the + icon. +If you hit Apply or OK the themes +selected for removal are actually deleted, so you cannot undo individual or all +deletions. + + + +Configure Icon Sizes + + +Select one of the components and use the slider to adapt the corresponding size. + + + +Configure Icon Sizes + + + + + + Configure Icon Sizes + + + + + + +Get New Icons... + + +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 Install in the dialog will install the chosen icon theme and after you Close the installer your new theme is immediately available. + + + +Get New Icon Themes + + + + + + Get New Icon Themes + + + + + + +Install from File... + + +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 icon theme tarball you have on your disk. + +Clicking Open in this dialog will install the theme you pointed to and make it available in the theme list. + + + + + +
diff --git a/doc/kcontrol/icons/main.png b/doc/kcontrol/icons/main.png new file mode 100644 index 000000000..bbccb2dfb Binary files /dev/null and b/doc/kcontrol/icons/main.png differ diff --git a/doc/kcontrol/icons/use-of-icons.png b/doc/kcontrol/icons/use-of-icons.png new file mode 100644 index 000000000..5463a6d9c Binary files /dev/null and b/doc/kcontrol/icons/use-of-icons.png differ