diff --git a/resources/desktop/com.github.rssguard.appdata.xml b/resources/desktop/com.github.rssguard.appdata.xml index f2e9830c0..10f8dda57 100644 --- a/resources/desktop/com.github.rssguard.appdata.xml +++ b/resources/desktop/com.github.rssguard.appdata.xml @@ -30,7 +30,7 @@ https://martinrotter.github.io/donate/ - + none diff --git a/resources/docs/Documentation.md b/resources/docs/Documentation.md index 074a8867b..6e268893e 100755 --- a/resources/docs/Documentation.md +++ b/resources/docs/Documentation.md @@ -17,6 +17,7 @@ Welcome to RSS Guard documentation. You can find everything about the applicatio ### [`Minor Features`]() #####     [`Files Downloader`](#downl) #####     [`Labels`](#lbls) +#####     [`Skins`](#skin) #####     [`GUI Tweaking`](#guit) #####     [`Command Line Interface (CLI)`](#cli) ### [`For Contributors`](#contrib) @@ -441,9 +442,30 @@ Note that (de)assignments of labels to messages are synchronized back to support Also, [message filters](#fltr) can assign or remove labels to/from messages. -### GUI Tweaking +### Skins +RSS Guard is skinable application. Its GUI can be almost completely styled with [stylesheets](https://doc.qt.io/qt-5/stylesheet.html). -RSS Guard's main window appearance can be tweaked in many ways. You can hide menu, toolbars, status bar, you can also change orientation of article viewer to suit widescreen devices. You can change skins and icon themes. + + +You can select style and skin in settings category `User interface`. + +RSS Guard encapsulates styling capabilities via *skins* feature. Each skin is placed in its own folder and must contain several [files](https://github.com/martinrotter/rssguard/tree/master/resources/skins/vergilius). There are some [built-in](https://github.com/martinrotter/rssguard/tree/master/resources/skins) skins, but you can place your custom skins in your [user data folder](#userd). You can find exact path to your user data folder in `About` dialog. Note that there must be subfolder `skins`. Create it if it does not exist and place your custom skins inside. + + + +So for example if your new skin is called `greenland`, you must place it in folder + +``` +\skins\greenland +``` + +As stated above, there are several files in each skin: +* `metadata.xml` - XML file with some basic information about the skin's name, author etc. Also, +* `theme.css` - [Qt stylesheet](https://doc.qt.io/qt-5/stylesheet.html) file. +* `html_*.html` - These are (partial) HTML files which are used by RSS Guard in various situations like displaying article or error page. + +### GUI Tweaking +RSS Guard's main window appearance can be tweaked in many ways. You can hide menu, toolbars, status bar, you can also change orientation of article viewer to suit widescreen devices. diff --git a/resources/docs/images/about-skins.png b/resources/docs/images/about-skins.png new file mode 100755 index 000000000..f10b116d6 Binary files /dev/null and b/resources/docs/images/about-skins.png differ diff --git a/src/librssguard/gui/dialogs/formabout.ui b/src/librssguard/gui/dialogs/formabout.ui index 865d86497..53fd2e699 100644 --- a/src/librssguard/gui/dialogs/formabout.ui +++ b/src/librssguard/gui/dialogs/formabout.ui @@ -92,7 +92,7 @@ - 1 + 0 @@ -235,7 +235,7 @@ p, li { white-space: pre-wrap; } 0 0 - 83 + 98 69