PolytreeDE/rofi
1
0
Fork 0
mirror of https://github.com/davatorium/rofi.git synced 2024-11-18 13:54:36 -05:00
Code Releases Activity

Add theming section to manpage.

Browse source
This commit is contained in:
QC 2015-04-06 22:17:05 +02:00
parent 10b22e0c7d
commit 9dc6df2f01
2 changed files with 88 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

37
doc/rofi-manpage.markdown
View file

@ -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
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

51
doc/rofi.1
View file

@ -613,6 +613,57 @@ If in daemon mode, reload the configuration from Xresources. (commandline argume
.RE
.PP
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
.PP
Rofi has an experimental mode for a 'nicer' transparency. The idea is that you can make the