mirror of
https://github.com/davatorium/rofi.git
synced 2024-11-18 13:54:36 -05:00
Add theming section to manpage.
This commit is contained in:
parent
10b22e0c7d
commit
9dc6df2f01
2 changed files with 88 additions and 0 deletions
|
@ -494,6 +494,43 @@ This way it can be used as a drop-in replacement for dmenu. just copy or symlink
|
||||||
If in daemon mode, reload the configuration from Xresources. (commandline arguments still
|
If in daemon mode, reload the configuration from Xresources. (commandline arguments still
|
||||||
override xresources).
|
override xresources).
|
||||||
|
|
||||||
|
## Theming
|
||||||
|
|
||||||
|
With **rofi** 0.15.4 we have a new way of specifying colors, the old settings still apply (for now)
|
||||||
|
and override the new setup. The new setup allows you to specify colors per state, similar to **i3**
|
||||||
|
Currently 3 states exists:
|
||||||
|
|
||||||
|
* **normal** Normal row.
|
||||||
|
* **urgent** Highlighted row (urgent)
|
||||||
|
* **active** Highlighted row (active)
|
||||||
|
|
||||||
|
For each state the following 5 colors must be set:
|
||||||
|
|
||||||
|
* **bg** Background color row
|
||||||
|
* **fg** Text color
|
||||||
|
* **bgalt** Background color alternating row
|
||||||
|
* **hlfg** Foreground color selected row
|
||||||
|
* **hlbg** Background color selected row
|
||||||
|
|
||||||
|
The window background and border color should be specified separate. The key `color-window` contains
|
||||||
|
a pair `background,border`.
|
||||||
|
An example for `Xresources` file:
|
||||||
|
|
||||||
|
```
|
||||||
|
! State: 'bg', 'fg', 'bgalt', 'hlfg', 'hlbg'
|
||||||
|
rofi.color-normal: #fdf6e3, #002b36, #eee8d5, #586e75, #eee8d5
|
||||||
|
rofi.color-urgent: #fdf6e3, #dc322f, #eee8d5, #dc322f, #fdf6e3
|
||||||
|
rofi.color-active: #fdf6e3, #268bd2, #eee8d5, #268bd2, #fdf6e3
|
||||||
|
|
||||||
|
! 'background', 'border'
|
||||||
|
rofi.color-window: #fdf6e3, #002b36
|
||||||
|
```
|
||||||
|
|
||||||
|
Same settings can also be specified on command-line:
|
||||||
|
|
||||||
|
```
|
||||||
|
rofi -color-normal "#fdf6e3,#002b36,#eee8d5,#586e75,#eee8d5"
|
||||||
|
```
|
||||||
|
|
||||||
## Colors
|
## Colors
|
||||||
|
|
||||||
|
|
51
doc/rofi.1
51
doc/rofi.1
|
@ -613,6 +613,57 @@ If in daemon mode, reload the configuration from Xresources. (commandline argume
|
||||||
.RE
|
.RE
|
||||||
.PP
|
.PP
|
||||||
override xresources).
|
override xresources).
|
||||||
|
.SH Theming
|
||||||
|
.PP
|
||||||
|
With \fBrofi\fP 0.15.4 we have a new way of specifying colors, the old settings still apply (for now)
|
||||||
|
and override the new setup. The new setup allows you to specify colors per state, similar to \fBi3\fP
|
||||||
|
Currently 3 states exists:
|
||||||
|
.RS
|
||||||
|
.IP \(bu 2
|
||||||
|
\fBnormal\fP Normal row.
|
||||||
|
.IP \(bu 2
|
||||||
|
\fBurgent\fP Highlighted row (urgent)
|
||||||
|
.br
|
||||||
|
.IP \(bu 2
|
||||||
|
\fBactive\fP Highlighted row (active)
|
||||||
|
.RE
|
||||||
|
.PP
|
||||||
|
For each state the following 5 colors must be set:
|
||||||
|
.RS
|
||||||
|
.IP \(bu 2
|
||||||
|
\fBbg\fP Background color row
|
||||||
|
.IP \(bu 2
|
||||||
|
\fBfg\fP Text color
|
||||||
|
.IP \(bu 2
|
||||||
|
\fBbgalt\fP Background color alternating row
|
||||||
|
.IP \(bu 2
|
||||||
|
\fBhlfg\fP Foreground color selected row
|
||||||
|
.IP \(bu 2
|
||||||
|
\fBhlbg\fP Background color selected row
|
||||||
|
.RE
|
||||||
|
.PP
|
||||||
|
The window background and border color should be specified separate. The key \fB\fCcolor\-window\fR contains
|
||||||
|
a pair \fB\fCbackground,border\fR\&.
|
||||||
|
An example for \fB\fCXresources\fR file:
|
||||||
|
.PP
|
||||||
|
.RS
|
||||||
|
.nf
|
||||||
|
! State: 'bg', 'fg', 'bgalt', 'hlfg', 'hlbg'
|
||||||
|
rofi.color\-normal: #fdf6e3, #002b36, #eee8d5, #586e75, #eee8d5
|
||||||
|
rofi.color\-urgent: #fdf6e3, #dc322f, #eee8d5, #dc322f, #fdf6e3
|
||||||
|
rofi.color\-active: #fdf6e3, #268bd2, #eee8d5, #268bd2, #fdf6e3
|
||||||
|
! 'background', 'border'
|
||||||
|
rofi.color\-window: #fdf6e3, #002b36
|
||||||
|
.fi
|
||||||
|
.RE
|
||||||
|
.PP
|
||||||
|
Same settings can also be specified on command\-line:
|
||||||
|
.PP
|
||||||
|
.RS
|
||||||
|
.nf
|
||||||
|
rofi \-color\-normal "#fdf6e3,#002b36,#eee8d5,#586e75,#eee8d5"
|
||||||
|
.fi
|
||||||
|
.RE
|
||||||
.SH Colors
|
.SH Colors
|
||||||
.PP
|
.PP
|
||||||
Rofi has an experimental mode for a 'nicer' transparency. The idea is that you can make the
|
Rofi has an experimental mode for a 'nicer' transparency. The idea is that you can make the
|
||||||
|
|
Loading…
Reference in a new issue