mirror of
https://github.com/awesomeWM/awesome
synced 2024-11-17 07:47:41 +01:00
80 lines
2.1 KiB
Text
80 lines
2.1 KiB
Text
awesomerc(5)
|
|
===========
|
|
|
|
NAME
|
|
----
|
|
|
|
awesomerc - Configuration file for the awesome window manager
|
|
|
|
SYNOPSIS
|
|
--------
|
|
*awesome* looks for this configuration file in this order:
|
|
|
|
* $XDG_CONFIG_HOME/awesome/rc.lua
|
|
* $HOME/.config/awesome/rc.lua
|
|
* XDG_CONFIG_DIRS/awesome/rc.lua
|
|
|
|
DESCRIPTION
|
|
-----------
|
|
The *awesomerc* file contains configuration informations for *awesome*. It can
|
|
be used to configure the behaviour and look of awesome in a variety of ways.
|
|
It can be assimilated as a Lua program/script run at startup by awesome.
|
|
Therefore, it should use the awesome Lua API described in the API section.
|
|
This file is read at startup.
|
|
|
|
AWESOME LUA API
|
|
---------------
|
|
|
|
Documentation for the Lua API can be found in the luadoc directory.
|
|
|
|
COLORS FORMAT
|
|
-------------
|
|
Colors format in *awesome* are either standard X color names
|
|
(blue, darkblue, lightred, etc) or hexadecimal formatted colors (#rrggbb
|
|
or #rrggbbaa).
|
|
By using hexadecimal format, you can also specifies an alpha channel:
|
|
that means that #00ff00 will draw pure green, but #00ff00aa will set the
|
|
alpha channel to `aa' and will blend the green with the color under it.
|
|
|
|
TEXT FORMAT
|
|
-----------
|
|
You can use and mix Pango markup and awesome markup in text string.
|
|
This allows to format the text rendered in widgets.
|
|
Pango markup documentation can be found in the Pango documentation at
|
|
http://library.gnome.org/devel/pango/stable/PangoMarkupFormat.html.
|
|
|
|
List of awesome markup elements and their attributes:
|
|
|
|
* bg
|
|
- color: background color
|
|
- image: background image
|
|
- align: background image alignment
|
|
- resize: resize background image to text size
|
|
* border
|
|
- color: border color
|
|
- width: border width
|
|
* margin
|
|
- left: left margin in pixel
|
|
- right: right margin in pixel
|
|
- top: top margin in pixel
|
|
* text
|
|
- align: text alignment
|
|
- shadow: shadow color
|
|
- shadow_offset: shadow color offset in pixel
|
|
|
|
|
|
A Pango markup example: <span weight="bold" foreground="#336699">...</span>.
|
|
|
|
An awesome markup example: <text align="right"/>.
|
|
|
|
SEE ALSO
|
|
--------
|
|
awesome(1) awesome-client(1)
|
|
|
|
AUTHORS
|
|
-------
|
|
Written by Julien Danjou <julien@danjou.info>.
|
|
|
|
WWW
|
|
---
|
|
http://awesome.naquadah.org
|