<section> [title]
{
<option> = <value>
<section> [title]
{
<option> = <value>
...
}
...
}
<option> = <value>
include(file.conf)
Il est lu au démarrage de awesome.
Toutes ces sections contiennent des options qui peuvent être une chaîne de caractères, un nombre entier, un nombre décimal, ou même encore des sections.
rules
menu
screen
keys
mouse
new_get_focus
floating_placement
new_become_master
sloppy_focus_raise
sloppy_focus
mwfact_lower_limit
resize_hints
snap
border
mwfact_upper_limit
opacity_focused
opacity_unfocused
arg
command
key
modkey
keylist
arglist
command
modkey
keylist
key
image
layout
styles
height
width
y
x
client
root
titlebar
button
arg
command
modkey
button
command
modkey
top
right
left
bottom
opacity
name
tags
screen
float
master
xproperty_name
titlebar
xproperty_value
icon
rule
styles
tags
statusbar
general
padding
layouts
titlebar
tasklist
layoutinfo
graph
height
width
emptybox
progressbar
position
focusicon
taglist
iconbox
textbox
bg
fg
shadow_offset
shadow
font
border
urgent
focus
normal
mwfact
ncol
layout
nmaster
tag
styles
align
text_align
height
width
position
y
x
align
mouse
style
align
width
y
x
mouse
bordercolor
bg
data
align
height
width
y
x
mouse
grow
vertical_gradient
fg_end
draw_style
scale
max
fg_center
fg
align
y
x
mouse
image
resize
ticks_gap
vertical
border_padding
data
align
gap
height
width
ticks_count
y
x
border_width
mouse
bordercolor
fg_end
bg
reverse
fg_off
fg_center
fg
y
x
align
mouse
styles
show_icons
show
text_align
y
x
mouse
style
text
align
text_align
width
y
x
mouse
quit
client_moveresize
client_focusnext
client_swapprev
client_swapnext
client_togglehorizontalmax
client_zoom
client_toggleverticalmax
client_settrans
client_togglefloating
client_togglescratch
client_focusprev
client_kill
client_togglemax
client_setscratch
focus_history
focus_client_byname
tag_setlayout
client_resizemouse
client_movemouse
screen_focus
client_movetoscreen
statusbar_toggle
tag_viewprev
tag_toggleview
tag_create
tag_viewnext
tag_view
client_tag
client_toggletag
tag_prev_selected
client_toggletitlebar
spawn
restart
exec
widget_tell
1. Ajoutez une directive "include" dans ~/.awesomerc
screen 0 { include(~/.awesome/bottom-status-bar) }
2. Créez ~/.awesome/bottom-status-bar
statusbar "bottom"
{
position = "bottom"
textbox "clock" { }
}
3. Recherchez les erreurs dans le fichier de configuration
$ awesome -k
Configuration file OK.
Note : si vous voyez autre chose que "Configuration file OK.", c'est que vous avez une coquille quelque part.
4. Créez ~/bin/awesome-clock
#!/bin/sh
while true
do
# if you start this from .xinitrc, the script will start before
# awesome, and will fail.
if [ -S ~/.awesome_ctl.0 ]; then
while true
do
echo "0 widget_tell bottom clock text «date`"
echo "" # an empty line flushes data inside awesome
sleep 1
done | awesome-client
else
sleep 1
fi
done
Note : cela signifie : awesome-client, dis à l'élément graphique de la barre d'état du bas, nommé «clock» de mettre sa propriété «text» à la valeur de la date.
5. Rendez exécutable votre ~/bin/awesome-clock
$ chmod a+x ~/bin/awesome-clock
6. Modifiez ~/.xinitrc
~/bin/awesome-clock &
exec awesome
7. Redémarrez awesome
8. Si vous n'obtenez pas ce que vous attendez, allez voir le fichier
~/.xsession-errors ou bien le terminal d'où X a démarré.
1. Ajoutez une directive "include" dans ~/.awesomerc
screen 0 { include(~/.awesome/bottom-status-bar) }
2. Créez ~/.awesome/bottom-status-bar
statusbar "bottom"
{
position = "bottom"
progressbar "diskusage"
{
data "disk"
{
bordercolor = "#006e96"
bg = "#000000"
fg = "#ff0000"
fg_center = "#daaf0a"
fg_end = "#00ff00"
}
width = 100
align = "left"
}
}
3. Recherchez les erreurs dans le fichier de configuration
$ awesome -k
Configuration file OK.
Note : si vous voyez autre chose que "Configuration file OK.", c'est que vous avez une coquille quelque part.
4. Créez ~/bin/awesome-diskusage
#!/bin/sh
while true
do
# if you start this from .xinitrc, the script will start before
# awesome, and will fail.
if [ -S ~/.awesome_ctl.0 ]; then
while true; do
usage = `df /dev/sda5 | awk '/\/dev\/sda5/ { print 100-$5 }'`
echo "0 widget_tell bottom diskusage data disk ${usage}"
echo "" # an empty line flushes data inside awesome
sleep 600;
done | awesome-client
else
sleep 1
fi
done
Note : cela signifie : awesome-client, dis à l'élément graphique de la barre d'état du bas, nommé «diskusage» de mettre sa propriété «data» nommée «disk» à la valeur ${usage}.
5. Rendez executable ~/bin/awesome-diskusage
$ chmod a+x ~/bin/awesome-diskusage
6. Modifiez ~/.xinitrc
~/bin/awesome-diskusage &
exec awesome
7. Redémarrez awesome
8. Si vous n'obtenez pas ce que vous attendez, allez voir le fichier
~/.xsession-errors ou bien le terminal d'où X a démarré.
Note : là où il n'y a pas de blanc, les guillemets sont optionnels.
<booléen> -> true (pour vrai) ou false (pour faux)
<couleur> -> Couleur en format X ou hexadécimal (ex. #aabbcc)
<décimal> -> Nombre décimal (ex. 0.2)
<police> -> Police Pango: [FAMILY-LIST] [STYLE-OPTIONS] [SIZE] (ex.Sans Italic 12)
<identifiant> -> Nom utilisé pour identifier (ex foobar)
<image> -> Chemin vers une image (ex. /home/user/image.jpg)
<entier> -> Nombre entier signé
<touche> -> Code KeySym (ex. F10) ou code KeyCodea (ex. #120)
<mod> -> Liste de modificateurs de touches (ex. Mod1)
<expregul> -> Expression régulière
<chaîne> -> Chaîne de caractères
<liste-chaîne> -> Liste de chaînes de caractères (ex. {a, b, c, ...})
<uicb-arg> -> Argument d'une fonction uicb
<uicb-cmd> -> Fonction Uicb, voir FONCTIONS UICB
<section-style> -> Section de style : {fg= bg= border= font= shadow= shadow_offset= }
<{.., ...}> -> Liste d'options disponibles
[MULTI] -> Peut-être utilisé plusieurs fois.
screen <identifier> [MULTI]
{
general
{
border = <entier>
snap = <entier>
resize_hints = <booléen>
sloppy_focus = <booléen>
sloppy_focus_raise = <booléen>
new_become_master = <booléen>
new_get_focus = <booléen>
opacity_unfocused = <décimal>
opacity_focused = <décimal>
floating_placement = <{smart,under_mouse}>
mwfact_lower_limit = <décimal>
mwfact_upper_limit = <décimal>
}
titlebar
{
position = <{top, bottom, left, right, auto, off}>
align = <{auto, left, right}>
width = <entier>
height = <entier>
text_align = <{left, center, right}>
styles
{
normal
{
<section-style>
}
focus
{
<section-style>
}
urgent
{
<section-style>
}
}
}
statusbar <identifier> [MULTI]
{
position = <{top, bottom, left, right, auto, off}>
height = <entier>
width = <entier>
textbox <identifier> [MULTI]
{
x = <entier>
y = <entier>
align = <{auto, left, right}>
mouse [MULTI]
{
modkey = <mod>
button = <chaîne>
command = <uicb-cmd>
arg = <uicb-arg>
}
width = <entier>
text = <chaîne>
text_align = <{left, center, right}>
style
{
<section-style>
}
}
emptybox <identifier> [MULTI]
{
x = <entier>
y = <entier>
align = <{auto, left, right}>
mouse [MULTI]
{
modkey = <mod>
button = <chaîne>
command = <uicb-cmd>
arg = <uicb-arg>
}
width = <entier>
style
{
<section-style>
}
}
taglist <identifier> [MULTI]
{
x = <entier>
y = <entier>
align = <{auto, left, right}>
mouse [MULTI]
{
modkey = <mod>
button = <liste-chaîne>
command = <uicb-cmd>
}
}
layoutinfo <identifier> [MULTI]
{
x = <entier>
y = <entier>
align = <{auto, left, right}>
mouse [MULTI]
{
modkey = <mod>
button = <chaîne>
command = <uicb-cmd>
arg = <uicb-arg>
}
}
iconbox <identifier> [MULTI]
{
x = <entier>
y = <entier>
align = <{auto, left, right}>
mouse [MULTI]
{
modkey = <mod>
button = <chaîne>
command = <uicb-cmd>
arg = <uicb-arg>
}
image = <image>
resize = <booléen>
}
focusicon <identifier> [MULTI]
{
x = <entier>
y = <entier>
align = <{auto, left, right}>
mouse [MULTI]
{
modkey = <mod>
button = <chaîne>
command = <uicb-cmd>
arg = <uicb-arg>
}
}
progressbar <identifier> [MULTI]
{
x = <entier>
y = <entier>
align = <{auto, left, right}>
mouse [MULTI]
{
modkey = <mod>
button = <chaîne>
command = <uicb-cmd>
arg = <uicb-arg>
}
data <identifier> [MULTI]
{
fg = <couleur>
fg_center = <couleur>
fg_end = <couleur>
fg_off = <couleur>
bg = <couleur>
bordercolor = <couleur>
reverse = <booléen>
}
width = <entier>
gap = <entier>
border_width = <entier>
border_padding = <entier>
ticks_gap = <entier>
ticks_count = <entier>
height = <décimal>
vertical = <booléen>
}
graph <identifier> [MULTI]
{
x = <entier>
y = <entier>
align = <{auto, left, right}>
mouse [MULTI]
{
modkey = <mod>
button = <chaîne>
command = <uicb-cmd>
arg = <uicb-arg>
}
data <identifier> [MULTI]
{
max = <décimal>
scale = <booléen>
fg = <couleur>
fg_center = <couleur>
fg_end = <couleur>
vertical_gradient = <booléen>
draw_style = <{bottom, top, line}>
}
width = <entier>
grow = <{left, right}>
height = <décimal>
bg = <couleur>
bordercolor = <couleur>
}
tasklist <identifier> [MULTI]
{
x = <entier>
y = <entier>
mouse [MULTI]
{
modkey = <mod>
button = <chaîne>
command = <uicb-cmd>
arg = <uicb-arg>
}
styles
{
normal
{
<section-style>
}
focus
{
<section-style>
}
urgent
{
<section-style>
}
}
text_align = <{left, center, right}>
show = <{all,tags,focus}>
show_icons = <booléen>
}
}
tags
{
tag <identifier> [MULTI]
{
layout = <chaîne>
mwfact = <décimal>
nmaster = <entier>
ncol = <entier>
}
}
styles
{
normal
{
<section-style>
}
focus
{
<section-style>
}
urgent
{
<section-style>
}
}
layouts
{
layout <title> [MULTI]
{
image = <image>
}
}
padding
{
top = <entier>
bottom = <entier>
right = <entier>
left = <entier>
}
}
rules
{
rule [MULTI]
{
xproperty_name = <chaîne>
xproperty_value = <expregul>
name = <expregul>
tags = <expregul>
icon = <chaîne>
float = <{auto,true,false}>
master = <{auto,true,false}>
titlebar
{
position = <{top, bottom, left, right, auto, off}>
align = <{auto, left, right}>
width = <entier>
height = <entier>
text_align = <{left, center, right}>
styles
{
normal
{
<section-style>
}
focus
{
<section-style>
}
urgent
{
<section-style>
}
}
}
screen = <entier>
opacity = <décimal>
}
}
keys
{
key [MULTI]
{
modkey = <mod>
key = <touche>
command = <uicb-cmd>
arg = <uicb-arg>
}
keylist [MULTI]
{
modkey = <mod>
keylist = <touche, ...>
command = <uicb-cmd>
arglist = <liste-chaîne>
}
}
mouse
{
root [MULTI]
{
modkey = <mod>
button = <chaîne>
command = <uicb-cmd>
arg = <uicb-arg>
}
client [MULTI]
{
modkey = <mod>
button = <chaîne>
command = <uicb-cmd>
arg = <uicb-arg>
}
titlebar [MULTI]
{
modkey = <mod>
button = <chaîne>
command = <uicb-cmd>
arg = <uicb-arg>
}
}
menu <identifier> [MULTI]
{
width = <entier>
height = <entier>
x = <entier>
y = <entier>
styles
{
normal
{
<section-style>
}
focus
{
<section-style>
}
urgent
{
<section-style>
}
}
}
L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité.
La version anglaise la plus à jour de ce document est toujours consultable via la commande : LANGUAGE=en man awesomerc. N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.