diff options
author | Michael Stapelberg <michael@stapelberg.de> | 2022-10-30 22:04:05 +0100 |
---|---|---|
committer | Michael Stapelberg <stapelberg@users.noreply.github.com> | 2022-10-30 22:22:08 +0100 |
commit | 0b89d4b2a7ae84a852a707d71cf2697e55581ee7 (patch) | |
tree | 5e4bb7059a174cea797348a034aef5ff829350af /docs | |
parent | 327bca26d87332bddb5969fe93a6a2283f50a363 (diff) | |
download | i3-0b89d4b2a7ae84a852a707d71cf2697e55581ee7.tar.gz i3-0b89d4b2a7ae84a852a707d71cf2697e55581ee7.zip |
implement bar { padding } config directive
related to https://github.com/i3/i3/issues/3724
related to https://github.com/i3/i3/pull/4288
fixes https://github.com/i3/i3/issues/3721
Diffstat (limited to 'docs')
-rw-r--r-- | docs/userguide | 43 |
1 files changed, 43 insertions, 0 deletions
diff --git a/docs/userguide b/docs/userguide index 29c0cd44..b25fad05 100644 --- a/docs/userguide +++ b/docs/userguide @@ -1980,6 +1980,49 @@ while +#000000FF+ will be a fully opaque black (the same as +#000000+). Please note that due to the way the tray specification works, enabling this flag will cause all tray icons to have a transparent background. +[[i3bar_padding]] +=== Padding + +To make i3bar higher (without increasing the font size), and/or add padding to +the left and right side of i3bar, you can use the +padding+ directive: + +*Syntax*: +-------------------------------------- +bar { + # 2px left/right and 2px top/bottom padding + padding 2px + + # 2px top/bottom padding, no left/right padding + padding 2px 0 + + # 2px top padding, no left/right padding, 4px bottom padding + padding 2px 0 4px + + # four value syntax + padding top[px] right[px] bottom[px] left[px] +} +-------------------------------------- + +*Examples*: +-------------------------------------- +bar { + # 2px left/right and 2px top/bottom padding + padding 2px + + # 2px top/bottom padding, no left/right padding + padding 2px 0 + + # 2px top padding, no left/right padding, 4px bottom padding + padding 2px 0 4px + + # 2px top padding, 6px right padding, 4px bottom padding, 1px left padding + padding 2px 6px 4px 1px +} +-------------------------------------- + +Note: As a convenience for users who migrate from i3-gaps to i3, the +height+ +directive from i3-gaps is supported by i3, but should be changed to +padding+. + [[list_of_commands]] == List of commands |