https://github.com/lxqt/lxqt-common-deprecated

Common files for LXQt
https://github.com/lxqt/lxqt-common-deprecated

Last synced: 5 days ago
JSON representation

Common files for LXQt

• Host: GitHub
• URL: https://github.com/lxqt/lxqt-common-deprecated
• Owner: lxqt
• Created: 2013-10-17T10:06:39.000Z (about 11 years ago)
• Default Branch: master
• Last Pushed: 2017-09-24T17:04:10.000Z (over 7 years ago)
• Last Synced: 2024-05-23T06:35:32.356Z (7 months ago)
• Language: CMake
• Homepage: https://lxqt.github.io
• Size: 10.3 MB
• Stars: 19
• Watchers: 20
• Forks: 19
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG

Awesome Lists containing this project

README

        
# lxqt-common

## Overview

This repository comprises a number of supportive files used by various LXQt components.   

Among other these are graphics files, themes, desktop entry files according to the [XDG Desktop Menu Specification](https://www.freedesktop.org/wiki/Specifications/menu-spec/), template configuration files of various components like PCManFM-Qt or window manager Openbox as well as script `startlxqt` used to initialize LXQt sessions.

The LXQt logo was designed by @Caig and is licensed CC-BY-SA 3.0. LXQt theme "Plasma" is based on KDE Plasma Next theme by the KDE Visual Team.

## Installation

### Compiling source code

Runtime dependencies are hicolor-icon-theme, bash and binary `xmessage`.   

Additional build dependencies are CMake and [liblxqt](https://github.com/lxde/liblxqt), optionally Git to pull latest VCS checkouts. The localization files were outsourced to repository [lxqt-l10n](https://github.com/lxde/lxqt-l10n) so the corresponding dependencies are needed, too. Please refer to this repository's `README.md` for further information.   

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

The library is provided by all major Linux distributions like Arch Linux, Debian, Fedora and openSUSE. Just use your package manager to search for string `lxqt-common`.

## Usage

#### LXQt specific configuration of window manager Openbox

Window manager Openbox is by default storing user settings in file `$XDG_CONFIG_HOME/openbox/rc.xml`, normally `/home//.config/openbox/rc.xml`. When Openbox is used as window manager of LXQt a file `$XDG_CONFIG_HOME/openbox/lxqt-rc.xml` is used instead. This allows for storing LXQt-specific settings while at the same time using different settings when Openbox is e. g. used in stand-alone window manager "only" sessions without any deskop environment. LXDE is using a custom configuration file `$XDG_CONFIG_HOME/openbox/lxde-rc.xml` the very same way.   

In order to keep backwards compatibility those configuration files are handled by LXQt as follows:

* `lxqt-common` ships a template file `$XDG_CONFIG_DIRS/openbox/lxqt-rc.xml`, normally `/etc/xdg/openbox/lxqt-rc.xml`.

* At the beginning of each LXQt session script `startlxqt` checks whether any of the files `rc.xml`, `lxde-rc.xml` or `lxqt-rc.xml` preexists in `$XDG_CONFIG_HOME/openbox/`.

* If neither of these files preexists `$XDG_CONFIG_DIRS/openbox/lxqt-rc.xml` is copied to `$XDG_CONFIG_HOME/openbox/lxqt-rc.xml`. If either `rc.xml` or `lxde-rc.xml` preexists in `$XDG_CONFIG_HOME/openbox/` it is copied to `$XDG_CONFIG_HOME/openbox/lxqt-rc.xml` as well.   

  Both times users are informed by binary `xmessage`.

* Either way this will result in file `$XDG_CONFIG_HOME/openbox/lxqt-rc.xml` being available which is from then on used within LXQt sessions.