From af7888d3b398e22ecc2322f833827f068ad87941 Mon Sep 17 00:00:00 2001 From: luke bonham Date: Sat, 4 Jan 2014 12:23:24 +0100 Subject: [PATCH 01/16] #18 fixed --- widgets/temp.lua | 10 ++++++++-- wiki | 2 +- 2 files changed, 9 insertions(+), 3 deletions(-) diff --git a/widgets/temp.lua b/widgets/temp.lua index b57c477..b55d52f 100644 --- a/widgets/temp.lua +++ b/widgets/temp.lua @@ -28,8 +28,14 @@ local function worker(args) function update() local f = io.open("/sys/class/thermal/thermal_zone0/temp") - coretemp_now = tonumber(f:read("*all")) / 1000 - f:close() + if f ~= nil + then + coretemp_now = tonumber(f:read("*all")) / 1000 + f:close() + else + coretemp_now = "N/A" + end + widget = temp.widget settings() end diff --git a/wiki b/wiki index c8e07d2..07a230f 160000 --- a/wiki +++ b/wiki @@ -1 +1 @@ -Subproject commit c8e07d2ec34cfb12907e4ccb5f29908aa8c98f5a +Subproject commit 07a230fb1654cc6abc1bd1ea8b36d8dcb3c1ad62 -- 2.39.2 From 13bdc435952fd58f00de64c59524af6c3f4f8de7 Mon Sep 17 00:00:00 2001 From: luke bonham Date: Sat, 4 Jan 2014 12:35:16 +0100 Subject: [PATCH 02/16] wiki updated --- README.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.rst b/README.rst index 07f4ee7..f59c04d 100644 --- a/README.rst +++ b/README.rst @@ -6,7 +6,7 @@ Layouts, widgets and utilities for Awesome WM --------------------------------------------- :Author: Luke Bonham -:Version: 1.0-git +:Version: git :License: GNU-GPLv2_ :Source: https://github.com/copycat-killer/lain -- 2.39.2 From f8734babc551421c842522dd86ad70bbaddd021d Mon Sep 17 00:00:00 2001 From: luke bonham Date: Thu, 9 Jan 2014 14:33:18 +0100 Subject: [PATCH 03/16] brigthness: unused lib removed --- widgets/contrib/brightness.lua | 1 - 1 file changed, 1 deletion(-) diff --git a/widgets/contrib/brightness.lua b/widgets/contrib/brightness.lua index 0ba2f45..04b8d2b 100644 --- a/widgets/contrib/brightness.lua +++ b/widgets/contrib/brightness.lua @@ -10,7 +10,6 @@ local newtimer = require("lain.helpers").newtimer local wibox = require("wibox") local io = { popen = io.popen } -local string = { match = string.match } local setmetatable = setmetatable -- 2.39.2 From 0ad1d66d7276b3bb67bae5dd71ae318e14be820f Mon Sep 17 00:00:00 2001 From: luke bonham Date: Mon, 13 Jan 2014 13:03:21 +0100 Subject: [PATCH 04/16] pull #19 satisfaction --- widgets/bat.lua | 3 ++- wiki | 2 +- 2 files changed, 3 insertions(+), 2 deletions(-) diff --git a/widgets/bat.lua b/widgets/bat.lua index 2906de2..b3f91dd 100644 --- a/widgets/bat.lua +++ b/widgets/bat.lua @@ -27,6 +27,7 @@ local function worker(args) local args = args or {} local timeout = args.timeout or 30 local battery = args.battery or "BAT0" + local notify = args.notify or true local settings = args.settings or function() end bat.widget = wibox.widget.textbox('') @@ -96,7 +97,7 @@ local function worker(args) end -- notifications for low and critical states - if bat_now.status == "Discharging" + if bat_now.status == "Discharging" and notify then if tonumber(bat_now.perc) <= 5 then diff --git a/wiki b/wiki index 07a230f..780ce12 160000 --- a/wiki +++ b/wiki @@ -1 +1 @@ -Subproject commit 07a230fb1654cc6abc1bd1ea8b36d8dcb3c1ad62 +Subproject commit 780ce12033c8aa90c5060280cfbdfd6fddc7584f -- 2.39.2 From a71b796ac8ade0d1743d82ede1a929bfa9ad3c9b Mon Sep 17 00:00:00 2001 From: luke bonham Date: Tue, 14 Jan 2014 09:46:06 +0100 Subject: [PATCH 05/16] revert to original pull request #19 --- widgets/bat.lua | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/widgets/bat.lua b/widgets/bat.lua index b3f91dd..48a14fb 100644 --- a/widgets/bat.lua +++ b/widgets/bat.lua @@ -27,7 +27,7 @@ local function worker(args) local args = args or {} local timeout = args.timeout or 30 local battery = args.battery or "BAT0" - local notify = args.notify or true + local notify = args.notify or "on" local settings = args.settings or function() end bat.widget = wibox.widget.textbox('') @@ -97,7 +97,7 @@ local function worker(args) end -- notifications for low and critical states - if bat_now.status == "Discharging" and notify + if bat_now.status == "Discharging" and notify == "on" then if tonumber(bat_now.perc) <= 5 then -- 2.39.2 From 0ef9d8c78f37353f96ab90e4f19ebb8341811b1d Mon Sep 17 00:00:00 2001 From: luke bonham Date: Tue, 14 Jan 2014 10:09:57 +0100 Subject: [PATCH 06/16] alsabar: fixed 'ticks' boolean issue; wiki updated --- widgets/alsabar.lua | 5 ++--- wiki | 2 +- 2 files changed, 3 insertions(+), 4 deletions(-) diff --git a/widgets/alsabar.lua b/widgets/alsabar.lua index 90d3a0d..365ac2d 100644 --- a/widgets/alsabar.lua +++ b/widgets/alsabar.lua @@ -95,7 +95,7 @@ local function worker(args) local settings = args.settings or function() end local width = args.width or 63 local height = args.heigth or 1 - local ticks = args.ticks or true + local ticks = args.ticks or false local ticks_size = args.ticks_size or 7 local vertical = args.vertical or false @@ -113,8 +113,7 @@ local function worker(args) alsabar.bar:set_height(height) alsabar.bar:set_ticks(ticks) alsabar.bar:set_ticks_size(ticks_size) - - if vertical then alsabar.bar:set_vertical(true) end + alsabar.bar:set_vertical(vertical) function alsabar.update() -- Get mixer control contents diff --git a/wiki b/wiki index 780ce12..41d28b9 160000 --- a/wiki +++ b/wiki @@ -1 +1 @@ -Subproject commit 780ce12033c8aa90c5060280cfbdfd6fddc7584f +Subproject commit 41d28b93ebbeb7e51584032e88c748426ea6cd82 -- 2.39.2 From 14705ce911ab9a2cca59de6bfbe9dacd3a0ca90d Mon Sep 17 00:00:00 2001 From: luke bonham Date: Mon, 20 Jan 2014 19:12:00 +0100 Subject: [PATCH 07/16] wiki: improved imap widget section --- wiki | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/wiki b/wiki index 41d28b9..ecf143b 160000 --- a/wiki +++ b/wiki @@ -1 +1 @@ -Subproject commit 41d28b93ebbeb7e51584032e88c748426ea6cd82 +Subproject commit ecf143be0d664ce754edeb1ed0ead3bd1104c7e6 -- 2.39.2 From 8dab1614a3e0c0c905c370acbef9015f985f9263 Mon Sep 17 00:00:00 2001 From: luke bonham Date: Mon, 20 Jan 2014 19:15:19 +0100 Subject: [PATCH 08/16] wiki: improved imap widget section --- wiki | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/wiki b/wiki index ecf143b..f996cdb 160000 --- a/wiki +++ b/wiki @@ -1 +1 @@ -Subproject commit ecf143be0d664ce754edeb1ed0ead3bd1104c7e6 +Subproject commit f996cdb74e7583534256d82706ef63d2b9811b42 -- 2.39.2 From a33a8afae0460b1c15526372cdb41fdaf4ebe647 Mon Sep 17 00:00:00 2001 From: luke bonham Date: Tue, 21 Jan 2014 15:42:33 +0100 Subject: [PATCH 09/16] revert #9; discouraging #21 and #22 situations --- widgets/mpd.lua | 16 ++-------------- widgets/yawn/init.lua | 2 +- 2 files changed, 3 insertions(+), 15 deletions(-) diff --git a/widgets/mpd.lua b/widgets/mpd.lua index 36c3ed7..1749b57 100644 --- a/widgets/mpd.lua +++ b/widgets/mpd.lua @@ -38,19 +38,7 @@ local function worker(args) local mpdcover = helpers.scripts_dir .. "mpdcover" local mpdh = "telnet://" .. host .. ":" .. port - - local echo = nil - - if password == "" then - echo = "(echo -e 'status'; sleep 0.1;" .. - "echo -e 'currentsong'; sleep 0.1;" .. - "echo -e 'close')" - else - echo = "(echo -e 'password " .. password .. "'" .. - "echo -e 'status'; sleep 0.1;" .. - "echo -e 'currentsong'; sleep 0.1;" .. - "echo -e 'close')" - end + local echo = "echo 'password " .. password .. "\nstatus\ncurrentsong\nclose'" mpd.widget = wibox.widget.textbox('') @@ -71,7 +59,7 @@ local function worker(args) date = "N/A" } - local f = io.popen(echo .. " | curl --connect-timeout 1 -fsm 1 " .. mpdh) + local f = io.popen(echo .. " | curl --connect-timeout 1 -fsm 3 " .. mpdh) for line in f:lines() do for k, v in string.gmatch(line, "([%w]+):[%s](.*)$") do diff --git a/widgets/yawn/init.lua b/widgets/yawn/init.lua index a2f756e..36cdf54 100644 --- a/widgets/yawn/init.lua +++ b/widgets/yawn/init.lua @@ -46,7 +46,7 @@ yawn_notification_preset = {} local function fetch_weather() local url = api_url .. units_set .. city_id - local f = io.popen("curl --connect-timeout 1 -fsm 1 '" .. url .. "'" ) + local f = io.popen("curl --connect-timeout 1 -fsm 3 '" .. url .. "'" ) local text = f:read("*all") f:close() -- 2.39.2 From a2d553c9b6f59e3da9f25221dfb42ba4053acb44 Mon Sep 17 00:00:00 2001 From: luke bonham Date: Tue, 21 Jan 2014 16:01:28 +0100 Subject: [PATCH 10/16] simple fix to #20 --- widgets/temp.lua | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/widgets/temp.lua b/widgets/temp.lua index b55d52f..61a9aa5 100644 --- a/widgets/temp.lua +++ b/widgets/temp.lua @@ -22,12 +22,13 @@ local temp = {} local function worker(args) local args = args or {} local timeout = args.timeout or 5 + local tempfile = args.tempfile or "/sys/class/thermal/thermal_zone0/temp" local settings = args.settings or function() end temp.widget = wibox.widget.textbox('') function update() - local f = io.open("/sys/class/thermal/thermal_zone0/temp") + local f = io.open(tempfile) if f ~= nil then coretemp_now = tonumber(f:read("*all")) / 1000 -- 2.39.2 From 9ec8af2c6f2d4b5c94949aa0502ab994f120d0af Mon Sep 17 00:00:00 2001 From: Luke Bonham Date: Sat, 7 Sep 2013 03:05:00 -0700 Subject: [PATCH 11/16] Initial Commit --- Home.md | 1 + 1 file changed, 1 insertion(+) create mode 100644 Home.md diff --git a/Home.md b/Home.md new file mode 100644 index 0000000..a520d81 --- /dev/null +++ b/Home.md @@ -0,0 +1 @@ +Welcome to the lain wiki! \ No newline at end of file -- 2.39.2 From 00cd5d9e596528c808ffec67df7cb726dff6ffe9 Mon Sep 17 00:00:00 2001 From: Luke Bonham Date: Sat, 7 Sep 2013 03:10:58 -0700 Subject: [PATCH 12/16] Created To start (markdown) --- To-start.md | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) create mode 100644 To-start.md diff --git a/To-start.md b/To-start.md new file mode 100644 index 0000000..9135be2 --- /dev/null +++ b/To-start.md @@ -0,0 +1,26 @@ +All you have to do is to include the module: + + local lain = require("lain") + +Some widgets require a terminal, lain default is `xterm`, but can be changed: + + lain.widgets.terminal = "urxvtc" + +or + + lain.widgets.terminal = terminal + +providing you have something like this: + + terminal = "urxvtc" + +in your `rc.lua`. + +`terminal` may also be a lua function that accepts one parameter. +Something like this: + + function footerm(cmd) + -- elaborate cmd + end + + lain.widgets.terminal = footerm \ No newline at end of file -- 2.39.2 From 8c213f95cf9beebd872fc3116380053a0f0334a6 Mon Sep 17 00:00:00 2001 From: Luke Bonham Date: Sat, 7 Sep 2013 03:11:44 -0700 Subject: [PATCH 13/16] Created mem (markdown) --- mem.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) create mode 100644 mem.md diff --git a/mem.md b/mem.md new file mode 100644 index 0000000..58ccf72 --- /dev/null +++ b/mem.md @@ -0,0 +1,19 @@ +Show used memory and total memory in MiB. + + mymem = lain.widgets.mem() + + +The function takes a table as an optional argument. That table may +contain: + +Variable | Meaning | Type | Default +--- | --- | --- | --- +`refresh_timeout` | Refresh timeout seconds | int | 10 +`show_swap` | Show amount of used swap space? | boolean | false +`show_total` | Show amout of total memory? | boolean | false +`header` | Text to show before value | string | " Vol " +`header_color` | Header color | string | `beautiful.fg_normal` or "#FFFFFF" +`color` | Value color | string | `beautiful.fg_focus` or "#FFFFFF" +`footer` | Text to show after value | string | "MB" + +**Note**: `footer` color is `color`. \ No newline at end of file -- 2.39.2 From f7dc89c8fdb9eba9ce2ce4743f52b6f19874fcf0 Mon Sep 17 00:00:00 2001 From: Luke Bonham Date: Sat, 7 Sep 2013 03:12:36 -0700 Subject: [PATCH 14/16] Created maildir (markdown) --- maildir.md | 37 +++++++++++++++++++++++++++++++++++++ 1 file changed, 37 insertions(+) create mode 100644 maildir.md diff --git a/maildir.md b/maildir.md new file mode 100644 index 0000000..df5f6fe --- /dev/null +++ b/maildir.md @@ -0,0 +1,37 @@ +Checks your maildirs. + +Maildirs are structured as follows: + + ~/Mail + . + |-- arch + | |-- cur + | |-- new + | `-- tmp + |-- gmail + | |-- cur + | |-- new + | `-- tmp + . + . + . + +therefore the widget checks whether there are files in the `new` directories. +If there's new mail, the textbox will say something like "mail: bugs(3), system(1)", otherwise it says +"no mail". + + mymaildir= lain.widgets.maildir("/path/to/my/maildir") + +The function takes a table as optional argument, which can contain: + +Variable | Meaning | Type | Default +--- | --- | --- | --- +`mailpath` | Path to your maildir | string | "~/Mail" +`ignore_boxes` | A list of boxes to ignore | table | empty table +`refresh_timeout` | Refresh timeout seconds | int | 60 +`header` | Text to show before value | string | " Mail " +`header_color` | Header color | string | `beautiful.fg_normal` or "#FFFFFF" +`color_newmail` | New mail value color | string | `beautiful.fg_focus` or "#FFFFFF" +`color_nomail` | No mail value color | string | `beautiful.fg_normal` or "#FFFFFF" +`app` | Mail program to spawn on click | string | "mutt"| boolean | false +`shadow` | Hide widget when there are no mails | boolean | false \ No newline at end of file -- 2.39.2 From 877e48a7a9f1db1d8ef773bcb0b6a7c728ef2858 Mon Sep 17 00:00:00 2001 From: Luke Bonham Date: Sat, 7 Sep 2013 03:16:55 -0700 Subject: [PATCH 15/16] Created Layouts (markdown) --- Layouts.md | 271 +++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 271 insertions(+) create mode 100644 Layouts.md diff --git a/Layouts.md b/Layouts.md new file mode 100644 index 0000000..b5aacc5 --- /dev/null +++ b/Layouts.md @@ -0,0 +1,271 @@ +Currently, there are **7** layouts. + + lain/layout + . + |-- cascade + |-- cascadetile + |-- centerwork + |-- termfair + |-- uselessfair + |-- uselesspiral + `-- uselesstile + +Just add your favourites to ``layouts`` table: + + layouts = + { + ... + lain.layout.termfair, + lain.layout.uselesstile, + ... + } + +Or set them on specific tags like this: + + awful.layout.set(lain.layout.uselessfair, tags[1][7]) + +How do layouts work? +========================= + +cascade +------- + +Cascade all windows of a tag. + +You can control the offsets by setting those two variables: + + lain.layout.cascade.cascade_offset_x = 64 + lain.layout.cascade.cascade_offset_y = 16 + +The following reserves space for 5 windows: + + lain.layout.cascade.nmaster = 5 + +That is, no window will get resized upon the creation of a new window, +unless there's more than 5 windows. + +cascadetile +----------- + +Similar to `awful.layout.suit.tile` layout, however, clients in the slave +column are cascaded instead of tiled. + +Left column size can be set, otherwise is controlled by `mwfact` of the +tag. Additional windows will be opened in another column on the right. +New windows are placed above old windows. + +Whether the slave column is placed on top of the master window or not is +controlled by the value of `ncol`. A value of 1 means "overlapping slave column" +and anything else means "don't overlap windows". + +Usage example: + + lain.layout.cascadetile.cascade_offset_x = 2 + lain.layout.cascadetile.cascade_offset_y = 32 + lain.layout.cascadetile.extra_padding = 5 + lain.layout.cascadetile.nmaster = 5 + lain.layout.ncol = 1 + +`extra_padding` reduces the size of the master window if "overlapping +slave column" is activated. This allows you to see if there are any +windows in your slave column. + +Setting `cascade_offset_x` to a very small value or even 0 is reccommended to avoid wasting space. + +centerwork +---------- + +You start with one window, centered horizontally: + + +--------------------------+ + | +----------+ | + | | | | + | | | | + | | | | + | | MAIN | | + | | | | + | | | | + | | | | + | | | | + | +----------+ | + +--------------------------+ + +This is your main working window. You do most of the work right here. +Sometimes, you may want to open up additional windows. They're put in +the following four slots: + + +--------------------------+ + | +---+ +----------+ +---+ | + | | | | | | | | + | | 0 | | | | 1 | | + | | | | | | | | + | +---+ | MAIN | +---+ | + | +---+ | | +---+ | + | | | | | | | | + | | 2 | | | | 3 | | + | | | | | | | | + | +---+ +----------+ +---+ | + +--------------------------+ + +Yes, the number "four" is fixed. In total, you can only have five open +windows with this layout. Additional windows are not managed and set to +floating mode. **This is intentional**. + +You can set the order of the four auxiliary windows. This is the default +configuration: + + lain.layout.centerwork.top_left = 0 + lain.layout.centerwork.top_right = 1 + lain.layout.centerwork.bottom_left = 2 + lain.layout.centerwork.bottom_right = 3 + +This means: The bottom left slot will be occupied by the third window +(not counting the main window). Suppose you want your windows to appear +in this order: + + +--------------------------+ + | +---+ +----------+ +---+ | + | | | | | | | | + | | 3 | | | | 0 | | + | | | | | | | | + | +---+ | MAIN | +---+ | + | +---+ | | +---+ | + | | | | | | | | + | | 2 | | | | 1 | | + | | | | | | | | + | +---+ +----------+ +---+ | + +--------------------------+ + +This would require you to use these settings: + + lain.layout.centerwork.top_left = 3 + lain.layout.centerwork.top_right = 0 + lain.layout.centerwork.bottom_left = 2 + lain.layout.centerwork.bottom_right = 1 + +*Please note:* If you use Awesome's default configuration, navigation in +this layout may be very confusing. How do you get from the main window +to satellite ones depends on the order in which the windows are opened. +Thus, use of `awful.client.focus.bydirection()` is suggested. +Here's an example: + + globalkeys = awful.util.table.join( + ... + awful.key({ modkey }, "j", + function() + awful.client.focus.bydirection("down") + if client.focus then client.focus:raise() end + end), + awful.key({ modkey }, "k", + function() + awful.client.focus.bydirection("up") + if client.focus then client.focus:raise() end + end), + awful.key({ modkey }, "h", + function() + awful.client.focus.bydirection("left") + if client.focus then client.focus:raise() end + end), + awful.key({ modkey }, "l", + function() + awful.client.focus.bydirection("right") + if client.focus then client.focus:raise() end + end), + ... + ) + +termfair +-------- + +I do a lot of work on terminals. The common tiling algorithms usually +maximize windows, so you'll end up with a terminal that has about 200 +columns or more. That's way too much. Have you ever read a manpage in a +terminal of this size? + +This layout restricts the size of each window. Each window will have the +same width but is variable in height. Furthermore, windows are +left-aligned. The basic workflow is as follows (the number above the +screen is the number of open windows, the number in a cell is the fixed +number of a client): + + (1) (2) (3) + +---+---+---+ +---+---+---+ +---+---+---+ + | | | | | | | | | | | | + | 1 | | | -> | 2 | 1 | | -> | 3 | 2 | 1 | -> + | | | | | | | | | | | | + +---+---+---+ +---+---+---+ +---+---+---+ + + (4) (5) (6) + +---+---+---+ +---+---+---+ +---+---+---+ + | 4 | | | | 5 | 4 | | | 6 | 5 | 4 | + +---+---+---+ -> +---+---+---+ -> +---+---+---+ + | 3 | 2 | 1 | | 3 | 2 | 1 | | 3 | 2 | 1 | + +---+---+---+ +---+---+---+ +---+---+---+ + +The first client will be located in the left column. When opening +another window, this new window will be placed in the left column while +moving the first window into the middle column. Once a row is full, +another row above it will be created. + +Default number of columns and rows are respectively taken from `nmaster` +and `ncol` values in `awful.tag`, but you can set your own. + +For example, this sets `termfair` to 3 columns and at least 1 row: + + lain.layout.termfair.nmaster = 3 + lain.layout.termfair.ncol = 1 + +uselessfair, uselesspiral & uselesstile +--------------------------------------- +These are duplicates of the stock `fair`, `spiral` and `tile` layouts. +However, "useless gaps" (see below) have been added. + +Useless gaps +============ + +Useless gaps are gaps between windows. They are "useless" because they +serve no special purpose despite increasing overview. I find it easier +to recognize window boundaries if windows are set apart a little bit. + +The `uselessfair` layout, for example, looks like this: + + +================+ + # # + # +---+ +---+ # + # | 1 | | | # + # +---+ | | # + # | 3 | # + # +---+ | | # + # | 2 | | | # + # +---+ +---+ # + # # + +================+ + +All of lain layouts provide useless gaps. To set the width of the gaps, +you have to add an item called `useless_gap_width` in your `theme.lua`. +If it doesn't exist, the width will default to 0. +Example: + + ... + theme.useless_gap_width = "5" + ... + +What about layout icons? +======================== + +They are located in ``lain/icons/layout``. + +To use them, add lines to your ``theme.lua`` like this: + + ... + theme.lain_icons = os.getenv("HOME") .. "/.config/awesome/lain/icons/layout/default/" + theme.layout_termfair = theme.lain_icons .. "termfairw.png" + theme.layout_cascade = theme.lain_icons .. "cascadew.png" + theme.layout_cascadetile = theme.lain_icons .. "cascadetilew.png" + theme.layout_centerwork = theme.lain_icons .. "centerworkw.png" + ... + +Credits goes to [Nicolas Estibals](https://github.com/nestibal) for creating +layout icons for default theme. + +You can use them as a template for your custom versions. \ No newline at end of file -- 2.39.2 From 0c3c9e43f01a7d6987528f5fbebd5e54861aab54 Mon Sep 17 00:00:00 2001 From: Luke Bonham Date: Sat, 7 Sep 2013 03:20:25 -0700 Subject: [PATCH 16/16] Updated Layouts (markdown) --- Layouts.md | 11 ++++------- 1 file changed, 4 insertions(+), 7 deletions(-) diff --git a/Layouts.md b/Layouts.md index b5aacc5..7f50efe 100644 --- a/Layouts.md +++ b/Layouts.md @@ -63,8 +63,8 @@ Usage example: lain.layout.cascadetile.cascade_offset_x = 2 lain.layout.cascadetile.cascade_offset_y = 32 lain.layout.cascadetile.extra_padding = 5 - lain.layout.cascadetile.nmaster = 5 - lain.layout.ncol = 1 + lain.layout.cascadetile.nmaster = 5 + lain.layout.ncol = 1 `extra_padding` reduces the size of the master window if "overlapping slave column" is activated. This allows you to see if there are any @@ -150,7 +150,7 @@ Thus, use of `awful.client.focus.bydirection()` is suggested. Here's an example: globalkeys = awful.util.table.join( - ... + ... awful.key({ modkey }, "j", function() awful.client.focus.bydirection("down") @@ -218,6 +218,7 @@ For example, this sets `termfair` to 3 columns and at least 1 row: uselessfair, uselesspiral & uselesstile --------------------------------------- These are duplicates of the stock `fair`, `spiral` and `tile` layouts. + However, "useless gaps" (see below) have been added. Useless gaps @@ -246,9 +247,7 @@ you have to add an item called `useless_gap_width` in your `theme.lua`. If it doesn't exist, the width will default to 0. Example: - ... theme.useless_gap_width = "5" - ... What about layout icons? ======================== @@ -257,13 +256,11 @@ They are located in ``lain/icons/layout``. To use them, add lines to your ``theme.lua`` like this: - ... theme.lain_icons = os.getenv("HOME") .. "/.config/awesome/lain/icons/layout/default/" theme.layout_termfair = theme.lain_icons .. "termfairw.png" theme.layout_cascade = theme.lain_icons .. "cascadew.png" theme.layout_cascadetile = theme.lain_icons .. "cascadetilew.png" theme.layout_centerwork = theme.lain_icons .. "centerworkw.png" - ... Credits goes to [Nicolas Estibals](https://github.com/nestibal) for creating layout icons for default theme. -- 2.39.2