diff options
| author | user <user@clank> | 2026-08-16 00:38:17 +0200 |
|---|---|---|
| committer | user <user@clank> | 2026-08-16 00:38:17 +0200 |
| commit | 8079f982bb240d6594b060caee7a5ac6f89e39b3 (patch) | |
| tree | e316fd3504360d1123774eb3a1a35459ef5ce725 /config | |
| parent | sl0ppty: sl0ppty --check (diff) | |
| download | slosh-8079f982bb240d6594b060caee7a5ac6f89e39b3.tar.gz slosh-8079f982bb240d6594b060caee7a5ac6f89e39b3.tar.xz slosh-8079f982bb240d6594b060caee7a5ac6f89e39b3.zip | |
sl0ppty: padding, per side
padding 1 // every side
padding 0 2 // vertical, horizontal
padding 2 0 0 1 // top, right, bottom, left
One value, two, or four in CSS order, because that is the order anybody
who has written a stylesheet already knows. `pad` becomes four fields and
the content rect is deflated per side rather than symmetrically, which is
the only real change: everything downstream already worked off
`n->content`.
The units do not change with how many numbers you write. They are ROWS,
like `gap`, and a horizontal one is multiplied by `gap_aspect` on the way
out -- so `padding 1`, `padding 1 1` and `padding 1 1 1 1` are one padding
rather than three, and a ring that looks square is still one number rather
than an arithmetic problem. Anyone who wants plain cells sets
`gap_aspect 1` and gets them everywhere, which is what that knob is for.
Three values is refused with a line saying what it wanted. CSS reads it as
top/horizontal/bottom, and a line whose meaning you have to look up is a
line nobody can read -- and `sl0ppty --check` now has something to say
about it, which is the difference between refusing and ignoring.
The dump writes the shortest form that means what is in force, so `padding
0` stays `padding 0` and a dump of a dump is still the same dump.
Checked by measuring both rects: a pane's insets from its own frame, four
numbers, for every form -- including that `gap_aspect 1` turns the
horizontal ones into cells, and that a refused padding leaves the rest of
the file applied.
Diffstat (limited to 'config')
| -rw-r--r-- | config/config.kdl | 15 |
1 files changed, 14 insertions, 1 deletions
diff --git a/config/config.kdl b/config/config.kdl index 77201a9..b0ff1f9 100644 --- a/config/config.kdl +++ b/config/config.kdl @@ -80,7 +80,20 @@ gap 1 // a gap of 1 row and 2 columns looks square. gap_aspect 2 -// Cells between a pane's frame and its content. +// Space between a pane's frame and its contents, in ROWS like `gap` -- a +// horizontal one is multiplied by `gap_aspect`, so `padding 1` is a ring that +// looks square rather than a squashed one. One number does every side; two are +// vertical then horizontal; four are CSS order, top right bottom left: +// +// padding 1 // all round +// padding 0 2 // none above or below, two either side +// padding 1 2 1 2 // the same thing, spelled out +// padding 2 0 0 1 // room for a title above, a gutter on the left +// +// A number means the same thing however many of them you write, which is why +// the first three of those are two paddings rather than three. Three values is +// refused: CSS reads it as top/horizontal/bottom, and a line whose meaning you +// have to look up is a line nobody can read. padding 0 // ╭╮╰╯ versus ┌┐└┘ |
