[DOC] Fix key names in theme location name.

This commit is contained in:
Dave Davenport 2021-10-12 22:47:40 +02:00
parent ccaaaf6a46
commit ec7aa09f0a

View file

@ -2,15 +2,15 @@
In the current theme format you set these properties on the `window` widget. 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 second what point of the **rofi** window connects there. This sounds
complicated, but it ain't. 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 * north
* northeast * northeast
@ -24,25 +24,25 @@ The position setting supports the following values:
This is depicted in the diagram below: This is depicted in the diagram below:
![positions](anchors.svg) ![location](anchors.svg)
## anchor setting ## 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`. *anchor* to `center`.
If the **rofi** window resizes, its center will stay at the 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 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. 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. > 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 ```css
window { window {
position: center; location: center;
anchor: north; 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) ![positions](example-pos.png)
> Quick hint, if you want to quickly test out changes to the theme, without editing the file, run **rofi** like: > Quick hint, if you want to quickly test out changes to the theme, without editing the file, run **rofi** like:
```bash ```bash
rofi -show run -theme-str "window { position: center; anchor: north;}" rofi -show run -theme-str "window { location: center; anchor: north;}"
``` ```