diff --git a/doc/Notes/Theme/Positioning/theme3-positioning.markdown b/doc/Notes/Theme/Positioning/theme3-positioning.markdown index c71266eb..83298232 100644 --- a/doc/Notes/Theme/Positioning/theme3-positioning.markdown +++ b/doc/Notes/Theme/Positioning/theme3-positioning.markdown @@ -2,15 +2,15 @@ In the current theme format you set these properties on the `window` widget. -The first, position, determines where **rofi** is placed on the monitor, the +The first, location, determines where **rofi** is placed on the monitor, the second what point of the **rofi** window connects there. This sounds complicated, but it ain't. -## position setting +## location setting -The position setting determines the place of the window on the monitor. +The location setting determines the place of the window on the monitor. -The position setting supports the following values: +The location setting supports the following values: * north * northeast @@ -24,25 +24,25 @@ The position setting supports the following values: This is depicted in the diagram below: -![positions](anchors.svg) +![location](anchors.svg) ## anchor setting -The anchor sets what point of the **rofi** window is placed at the specified *position*. +The anchor sets what point of the **rofi** window is placed at the specified *location*. -The *anchor* settings supports the same values as the *position* setting. +The *anchor* settings supports the same values as the *location* setting. -If you want the middle of the **rofi** window to be always located at the center of the monitor set both *position* and +If you want the middle of the **rofi** window to be always located at the center of the monitor set both *location* and *anchor* to `center`. If the **rofi** window resizes, its center will stay at the center. If you set the *anchor* to `north` the top of the **rofi** window is at the center of the monitor, and the window will grow down. -If you set the *anchor* and *position* to `south`, **rofi** is located at the bottom center and the window grows up. +If you set the *anchor* and *location* to `south`, **rofi** is located at the bottom center and the window grows up. -> Note that if you set the *anchor* to `south` and the *position* to `north` the **rofi** window will be placed above +> Note that if you set the *anchor* to `south` and the *location* to `north` the **rofi** window will be placed above > the monitor and might not be visible. @@ -52,17 +52,17 @@ So the following theme setting will place the top of the **rofi** window in the ```css window { - position: center; + location: center; anchor: north; } ``` -As depicted here, RED is the position (center of screen), GREEN is the position on **rofi** window (north): +As depicted here, RED is the location (center of screen), GREEN is the anchor on **rofi** window (north): ![positions](example-pos.png) > Quick hint, if you want to quickly test out changes to the theme, without editing the file, run **rofi** like: ```bash -rofi -show run -theme-str "window { position: center; anchor: north;}" +rofi -show run -theme-str "window { location: center; anchor: north;}" ```