PolytreeDE
/
rofi
mirror of https://github.com/davatorium/rofi.git
1
0
Fork 0
Code Releases Activity

[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
1 changed files with 13 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
doc/Notes/Theme/Positioning/theme3-positioning.markdown
View File

@ -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;}"
```