209 lines
4.3 KiB
Plaintext
209 lines
4.3 KiB
Plaintext
awesomerc(5)
|
|
===========
|
|
|
|
NAME
|
|
----
|
|
|
|
awesomerc - Configuration file for the awesome window manager
|
|
|
|
SYNOPSIS
|
|
--------
|
|
None.
|
|
|
|
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
|
|
---------------
|
|
Each function available in awesome Lua implementation is listed below.
|
|
Function named package.function are relative to the package and must be called
|
|
as is.
|
|
Function named object_type:function are objects methods and must be applied on
|
|
object with type "object_type".
|
|
|
|
include::apidocgen.txt[]
|
|
|
|
COLORS FORMAT
|
|
-------------
|
|
Colors format in *awesome* are either standard X color names
|
|
(blue, darkblue, lightred, etc) or hexadecimal formatted colors (#rrggbb).
|
|
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.
|
|
|
|
WIDGETS
|
|
-------
|
|
The current list of available widget is:
|
|
|
|
- iconbox
|
|
- graph
|
|
- progressbar
|
|
- taglist
|
|
- tasklist
|
|
- textbox
|
|
|
|
Each widget as its own set of properties, described below, that can bet modified with the set()
|
|
method.
|
|
|
|
ICONBOX
|
|
~~~~~~~
|
|
*image*::
|
|
The image path.
|
|
|
|
*resize*::
|
|
True if you want the image to be auto-resized.
|
|
|
|
PROGRESSBAR
|
|
~~~~~~~~~~~
|
|
A progressbar widget can contain several bars, so some properties need a data section,
|
|
that means a title for the bar. For example, if you want to feed data to the `memory' bar
|
|
you want to do mywidget:set("data", "memory 100"), where memory will be the data section.
|
|
Using a new data section name will automatically create a new bar.
|
|
|
|
|
|
The following properties require a data section before the value:
|
|
|
|
*data*::
|
|
Feed with data.
|
|
|
|
*fg*::
|
|
Foreground color.
|
|
|
|
*fg_off*::
|
|
Color of unfilled area of bar.
|
|
|
|
*bg*::
|
|
Background color (between ticks; border_padding space).
|
|
|
|
*bordercolor*::
|
|
Border color.
|
|
|
|
*fg_center*::
|
|
Foreground center color.
|
|
|
|
*fg_end*::
|
|
Foreground end color.
|
|
|
|
*min_value*::
|
|
Minimum value. This or lower values, draw a 0% bar.
|
|
|
|
*max_value*::
|
|
Maximum value. This or higher values, draw a 100% bar.
|
|
|
|
*reverse*::
|
|
True to draw reverse.
|
|
|
|
|
|
The following properties do not require a data section before the value and applies to all bars inside
|
|
the widget:
|
|
|
|
*gap*::
|
|
Gap between borders.
|
|
|
|
*ticks_count*::
|
|
The number of ticks.
|
|
|
|
*ticks_gap*::
|
|
The gap between ticks.
|
|
|
|
*border_padding*::
|
|
The padding inside the border.
|
|
|
|
*border_width*::
|
|
The border width.
|
|
|
|
*width*::
|
|
The widget width.
|
|
|
|
*height*::
|
|
The widget height.
|
|
|
|
*vertical*::
|
|
True if the widget is vertical.
|
|
|
|
GRAPH
|
|
~~~~~
|
|
A graph widget can display several data-graphs inside its widget-border. Some
|
|
properties need a data section, that means a title for the incoming data. For
|
|
example, if you want to feed 'memory' data, you want to do
|
|
mywidget:set("data", "memory 100").
|
|
|
|
|
|
The following properties require a data section before the value:
|
|
|
|
*data*::
|
|
Feed with data.
|
|
|
|
*fg*::
|
|
Foreground color.
|
|
|
|
*fg_center*::
|
|
Foreground center color.
|
|
|
|
*fg_end*::
|
|
Foreground end color.
|
|
|
|
*vertical_gradient*::
|
|
If 'true', colorgradient shall be applied vertically.
|
|
|
|
*max_value*::
|
|
Maximum value. Bigger values gets truncated, unless 'scale' is true.
|
|
|
|
*scale*::
|
|
Scales the graph acccording to incoming values bigger than 'max_value'.
|
|
|
|
*draw_style*::
|
|
'bottom', 'top' or 'line'.
|
|
|
|
|
|
The following properties do not require a data section before the value:
|
|
|
|
*width*::
|
|
The widget width.
|
|
|
|
*height*::
|
|
The widget height.
|
|
|
|
*bg*::
|
|
Background color.
|
|
|
|
*bordercolor*::
|
|
Border color.
|
|
|
|
*grow*::
|
|
'left' or 'right'. E.g. 'right' means new values get added on the right of the widget.
|
|
|
|
TAGLIST
|
|
~~~~~~~
|
|
No documentation yet.
|
|
|
|
TASKLIST
|
|
~~~~~~~~
|
|
No documentation yet.
|
|
|
|
TEXTBOX
|
|
~~~~~~~
|
|
*width*::
|
|
The widget width.
|
|
|
|
*text*::
|
|
Text to display. You can use pango-markup e.g. <span weight='bold' foreground="#336699">...</span>
|
|
and/or 'awesome-markup, e.g. <text align='right'>...</text>.
|
|
|
|
SEE ALSO
|
|
--------
|
|
awesome(1) awesome-client(1)
|
|
|
|
AUTHORS
|
|
-------
|
|
This man page was written by Julien Danjou <julien@danjou.info>.
|
|
|
|
WWW
|
|
---
|
|
http://awesome.naquadah.org
|