lxqt-qtplugin-packaging/README.md

# lxqt-qtplugin

## Overview

This repository is providing a library `libqtlxqt` to integrate Qt with LXQt.

With this plugin, all Qt-based programs can adopt settings of LXQt, such as the icon theme.

## Installation

### Compiling source code

Runtime dependencies are libdbusmenu-qt5 and [liblxqt](https://github.com/lxde/liblxqt).   
Additional build dependencies are CMake and qttools, optionally Git to pull latest VCS checkouts.   

Code configuration is handled by CMake. CMake variable `CMAKE_INSTALL_PREFIX` has to be set to `/usr` on most operating systems.   

To build run `make`, to install `make install` which accepts variable `DESTDIR` as usual.   

### Binary packages

Official binary packages are provided by all major Linux distributions like Arch Linux, Debian (as of Debian stretch only), Fedora and openSUSE. Just use your package manager to search for string `lxqt-qtplugin`.

## Configuration, Usage

To use the plugin in Qt 5, we have to export environment variable `QT_QPA_PLATFORMTHEME=lxqt`. Then every Qt5 program can load the theme plugin.   
If, for some unknown reasons, the plugin is not loaded, we can debug the plugin by exporting `QT_DEBUG_PLUGINS=1`. Then, Qt5 will print detailed information and error messages about all plugins in the console when running any Qt5 programs.
Cherry-picking upstream release 0.11.0. * Synced debian foo with experimental * Added Multi-Arch: same, following the Multiarch hinter * Bumped compat to 10 * Removed --parallel from rules, standard in compat 10 * Bumped Standards to 3.9.8, no changes needed * Bumped minimum version debhelper (>= 10) * Bumped minimum version liblxqt-dev (>= 0.11.0) * Bumped minimum version libqtxdg-dev (>= 2.0.0) * Added build dependency libqt5svg5-dev * Added build dependency libqt5xdgiconloader-dev * Fixed VCS fields, using https and plain /git/ * Removed README.debian, no longer needed * Fixed copyrights Format field to https * Bumped years in copyrights * Fixed copyrights Source field * Removed outdated file and license from copyrights * Added hardening options * Added translation control to rules * Set CMAKE_BUILD_TYPE=RelWithDebInfo * Exported LC_ALL=C.UTF-8, make builds reproducible * Added a basic gbp.conf 8 years ago			`# lxqt-qtplugin`
Cherry-picking upstream version 0.10.0. Fix debian/docs Set new minimum version for liblxqt 9 years ago
Cherry-picking upstream release 0.11.0. * Synced debian foo with experimental * Added Multi-Arch: same, following the Multiarch hinter * Bumped compat to 10 * Removed --parallel from rules, standard in compat 10 * Bumped Standards to 3.9.8, no changes needed * Bumped minimum version debhelper (>= 10) * Bumped minimum version liblxqt-dev (>= 0.11.0) * Bumped minimum version libqtxdg-dev (>= 2.0.0) * Added build dependency libqt5svg5-dev * Added build dependency libqt5xdgiconloader-dev * Fixed VCS fields, using https and plain /git/ * Removed README.debian, no longer needed * Fixed copyrights Format field to https * Bumped years in copyrights * Fixed copyrights Source field * Removed outdated file and license from copyrights * Added hardening options * Added translation control to rules * Set CMAKE_BUILD_TYPE=RelWithDebInfo * Exported LC_ALL=C.UTF-8, make builds reproducible * Added a basic gbp.conf 8 years ago			`## Overview`
Adding upstream version 0.9.0. Signed-off-by: Andrew Lee (李健秋) <ajqlee@debian.org> 9 years ago
Cherry-picking upstream release 0.11.0. * Synced debian foo with experimental * Added Multi-Arch: same, following the Multiarch hinter * Bumped compat to 10 * Removed --parallel from rules, standard in compat 10 * Bumped Standards to 3.9.8, no changes needed * Bumped minimum version debhelper (>= 10) * Bumped minimum version liblxqt-dev (>= 0.11.0) * Bumped minimum version libqtxdg-dev (>= 2.0.0) * Added build dependency libqt5svg5-dev * Added build dependency libqt5xdgiconloader-dev * Fixed VCS fields, using https and plain /git/ * Removed README.debian, no longer needed * Fixed copyrights Format field to https * Bumped years in copyrights * Fixed copyrights Source field * Removed outdated file and license from copyrights * Added hardening options * Added translation control to rules * Set CMAKE_BUILD_TYPE=RelWithDebInfo * Exported LC_ALL=C.UTF-8, make builds reproducible * Added a basic gbp.conf 8 years ago			This repository is providing a library `libqtlxqt` to integrate Qt with LXQt.
Adding upstream version 0.9.0. Signed-off-by: Andrew Lee (李健秋) <ajqlee@debian.org> 9 years ago
Cherry-picking upstream release 0.11.0. * Synced debian foo with experimental * Added Multi-Arch: same, following the Multiarch hinter * Bumped compat to 10 * Removed --parallel from rules, standard in compat 10 * Bumped Standards to 3.9.8, no changes needed * Bumped minimum version debhelper (>= 10) * Bumped minimum version liblxqt-dev (>= 0.11.0) * Bumped minimum version libqtxdg-dev (>= 2.0.0) * Added build dependency libqt5svg5-dev * Added build dependency libqt5xdgiconloader-dev * Fixed VCS fields, using https and plain /git/ * Removed README.debian, no longer needed * Fixed copyrights Format field to https * Bumped years in copyrights * Fixed copyrights Source field * Removed outdated file and license from copyrights * Added hardening options * Added translation control to rules * Set CMAKE_BUILD_TYPE=RelWithDebInfo * Exported LC_ALL=C.UTF-8, make builds reproducible * Added a basic gbp.conf 8 years ago			`With this plugin, all Qt-based programs can adopt settings of LXQt, such as the icon theme.`

			`## Installation`

			`### Compiling source code`

			`Runtime dependencies are libdbusmenu-qt5 and [liblxqt](https://github.com/lxde/liblxqt).`
			`Additional build dependencies are CMake and qttools, optionally Git to pull latest VCS checkouts.`

			Code configuration is handled by CMake. CMake variable `CMAKE_INSTALL_PREFIX` has to be set to `/usr` on most operating systems.

			To build run `make`, to install `make install` which accepts variable `DESTDIR` as usual.

			`### Binary packages`

			Official binary packages are provided by all major Linux distributions like Arch Linux, Debian (as of Debian stretch only), Fedora and openSUSE. Just use your package manager to search for string `lxqt-qtplugin`.

			`## Configuration, Usage`

			To use the plugin in Qt 5, we have to export environment variable `QT_QPA_PLATFORMTHEME=lxqt`. Then every Qt5 program can load the theme plugin.
			If, for some unknown reasons, the plugin is not loaded, we can debug the plugin by exporting `QT_DEBUG_PLUGINS=1`. Then, Qt5 will print detailed information and error messages about all plugins in the console when running any Qt5 programs.