mirror of
https://github.com/labwc/labwc.git
synced 2025-11-04 13:30:07 -05:00
141 lines
2.7 KiB
Markdown
141 lines
2.7 KiB
Markdown
% labwc(5)
|
|
% Johan Malm
|
|
% 22 July, 2020
|
|
|
|
# NAME
|
|
|
|
labwc - Configuration files
|
|
|
|
# CONFIGURATION
|
|
|
|
There are two configuration files which control the look and behaviour of
|
|
labwc, namely rc.xml and themerc. The configuration aims to be compatible with
|
|
Openbox, but there are some differences which are pointed out in this man page.
|
|
|
|
# RC.XML `<lab>`
|
|
|
|
Labwc specific settings which are not present in Openbox.
|
|
|
|
<lab>
|
|
<csd></csd>
|
|
<keyboard>
|
|
<layout></layout>
|
|
</keyboard>
|
|
</lab>
|
|
|
|
`csd` __boolean__ (default `no`)
|
|
|
|
: Use client-side decorations for xdg-shell views.
|
|
|
|
`keyboard-layout` __string__ (not set by default)
|
|
|
|
: Set `XKB_DEFAULT_LAYOUT`. See xkeyboard-config(7) for details.
|
|
|
|
# RC.XML `<theme>`
|
|
|
|
<theme>
|
|
<name></name>
|
|
</theme>
|
|
|
|
`name` __string__
|
|
|
|
: The name of the Openbox theme to use
|
|
|
|
# RC.XML `<keyboard>`
|
|
|
|
Describe key bindings.
|
|
|
|
<keyboard>
|
|
<keybind key="KEY-COMBINATION">
|
|
ACTION
|
|
</keybind>
|
|
<keyboard>
|
|
|
|
`KEY-COMBINATION`
|
|
|
|
: The key combination to bind to an **ACTION** in the format
|
|
**modifier-key**, where supported **modifiers** include S (shift);
|
|
C (control); A (alt); W (super). Unlike Openbox, multiple space-separated
|
|
**KEY-COMBINATION** and key-chains are not supported.
|
|
|
|
Example:
|
|
|
|
<keyboard>
|
|
<keybind key="A-Escape">
|
|
<action name="Exit"/>
|
|
</keybind>
|
|
<keybind key="A-Tab">
|
|
<action name="NextWindow"/>
|
|
</keybind>
|
|
<keybind key="A-F3">
|
|
<action name="Execute">
|
|
<command>dmenu_run</command>
|
|
</action>
|
|
</keybind>
|
|
<keyboard>
|
|
|
|
# ACTIONS
|
|
|
|
Actions are used in key bindings.
|
|
|
|
Action syntax:
|
|
|
|
<action name="NAME">
|
|
OPTION
|
|
</action>
|
|
|
|
`NAME`
|
|
|
|
: The name of the action as listed below.
|
|
|
|
`OPTION`
|
|
|
|
: A set of tags specific to each action as defined below.
|
|
|
|
`Execute`
|
|
|
|
: Execute command specified by `<command>` option.
|
|
|
|
`Exit`
|
|
|
|
: Exit labwc.
|
|
|
|
`NextWindow`
|
|
|
|
: Cycle focus to next window.
|
|
|
|
# THEMERC
|
|
|
|
`window.active.title.bg.color`
|
|
|
|
: Background for the focussed window's titlebar
|
|
|
|
`window.active.handle.bg.color`
|
|
|
|
: Background for the focussed window's handle.
|
|
|
|
`window.inactive.title.bg.color`
|
|
|
|
: Background for non-focussed windows' titlebars
|
|
|
|
# DEFINITIONS
|
|
|
|
The `handle` is the window decoration placed on the bottom of the window.
|
|
|
|
# EXAMPLES
|
|
|
|
## Example 1 - title bar configuration
|
|
|
|
+-----------------------------------------+ ^
|
|
| | |
|
|
| | |
|
|
| | | h
|
|
| | |
|
|
+-----------------------------------------+ v
|
|
|
|
h = padding * 2 + font-vertical-extents
|
|
|
|
|
|
# SEE ALSO
|
|
|
|
labwc(1)
|