A simple and static layout for Awesome with a rapid interactive layout editor.
## Why?
1. Dynamic tiling is an overkill, since tiling is only useful for persistent windows, and people extensively use hibernate/sleep these days.
2. I want to have a flexible layout such that I can quickly adjust to whatever I need.
## Use the layout
Use `layout-machi.layout.create_layout([LAYOUT_NAME}, [DEFAULT_REGIONS])` to instantiate the layout.
For example:
```
layout-machi.layout.create_layout("default", {})
```
Creates a layout with no regions
## Use the editor
Call `layout-machi.editor.start_editor(data)` to enter the editor for the current layout (given it is a machi instance).
`data` is am object for storing the history of the editing, initially `{}`.
The editor starts with the open area of the entire workarea, taking command to split the current area into multiple sub-areas, then editing each of them.
The editor is keyboard driven, accepting a number of command keys.
Before each command, you can optionally provide at most 2 digits for parameters (A, B) of the command.
By default A = B = 1.
1.`Up`/`Down`: restore to the history command sequence
2.`h`/`v`: split the current region horizontally/vertically into 2 regions. The split will respect the ratio A:B.
3.`w`: Take two parameters (A, B), and split the current region equally into A columns and B rows. If both A and B is 1, behave the same as `Space` without parameters.
4.`s`: shift the current editing region with other open sibling regions.
5.`Space` or `-`: Without parameters, close the current region and move to the next open region. With parameters, set the maximum depth of splitting (default is 2).
6.`Enter`/`.`: close all open regions. When all regions are closed, press `Enter` will save the layout and exit the editor.
7.`Backspace`: undo the last command.
8.`Escape`: exit the editor without saving the layout.
## Other functions
`layout-machi.editor.cycle_region(c)` will fit a floating client into the closest region, then cycle through all regions.
