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

[DOC] Regenerate manpages with newer go-md2man to fix escaping

Browse source
This commit is contained in:
Dave Davenport 2022-03-12 12:22:58 +01:00
parent 6bb9262245
commit d623e18fbb
7 changed files with 561 additions and 561 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

102
doc/rofi-dmenu.5
View file

@ -1,8 +1,8 @@
.nh .nh
.TH ROFI\-DMENU 5 rofi\-dmenu .TH ROFI-DMENU 5 rofi-dmenu
.SH NAME .SH NAME
.PP .PP
\fBrofi dmenu mode\fP \- Rofi dmenu emulation \fBrofi dmenu mode\fP - Rofi dmenu emulation
.SH DESCRIPTION .SH DESCRIPTION
.PP .PP
@ -15,8 +15,8 @@ The website for \fB\fCdmenu\fR can be found here
.PP .PP
\fBrofi\fP does not aim to be 100% compatible with \fB\fCdmenu\fR\&. There are simply too many flavors of \fB\fCdmenu\fR\&. \fBrofi\fP does not aim to be 100% compatible with \fB\fCdmenu\fR\&. There are simply too many flavors of \fB\fCdmenu\fR\&.
The idea is that the basic usage command\-\&line flags are obeyed, theme\-\&related flags are not. The idea is that the basic usage command-line flags are obeyed, theme-related flags are not.
Besides, \fBrofi\fP offers some extended features (like multi\-select, highlighting, message bar, extra key bindings). Besides, \fBrofi\fP offers some extended features (like multi-select, highlighting, message bar, extra key bindings).
.SH BASIC CONCEPT .SH BASIC CONCEPT
.PP .PP
@ -29,27 +29,27 @@ By default separation of rows is done on new lines, making it easy to pipe the o
.SH USAGE .SH USAGE
.PP .PP
By launching \fBrofi\fP with the \fB\fC\-dmenu\fR flag it will go into dmenu emulation mode. By launching \fBrofi\fP with the \fB\fC-dmenu\fR flag it will go into dmenu emulation mode.
.PP .PP
.RS .RS
.nf .nf
ls | rofi \-dmenu ls | rofi -dmenu
.fi .fi
.RE .RE
.SS DMENU DROP\-IN REPLACEMENT .SS DMENU DROP-IN REPLACEMENT
.PP .PP
If \fB\fCargv[0]\fR (calling command) is dmenu, \fBrofi\fP will start in dmenu mode. If \fB\fCargv[0]\fR (calling command) is dmenu, \fBrofi\fP will start in dmenu mode.
This way, it can be used as a drop\-in replacement for dmenu. Just copy or symlink \fBrofi\fP to dmenu in \fB\fC$PATH\fR\&. This way, it can be used as a drop-in replacement for dmenu. Just copy or symlink \fBrofi\fP to dmenu in \fB\fC$PATH\fR\&.
.PP .PP
.RS .RS
.nf .nf
ln \-s /usr/bin/rofi /usr/bin/dmenu ln -s /usr/bin/rofi /usr/bin/dmenu
.fi .fi
.RE .RE
@ -57,15 +57,15 @@ ln \-s /usr/bin/rofi /usr/bin/dmenu
.SS DMENU VS SCRIPT MODE .SS DMENU VS SCRIPT MODE
.PP .PP
Script mode is used to extend \fBrofi\fP, dmenu mode is used to extend a script. Script mode is used to extend \fBrofi\fP, dmenu mode is used to extend a script.
The two do share much of the same input format. Please see the \fBrofi\-script(5)\fP manpage for more information. The two do share much of the same input format. Please see the \fBrofi-script(5)\fP manpage for more information.
.SS DMENU SPECIFIC COMMANDLINE FLAGS .SS DMENU SPECIFIC COMMANDLINE FLAGS
.PP .PP
A lot of these options can also be modified by the script using special input. See the \fBrofi\-script(5)\fP manpage A lot of these options can also be modified by the script using special input. See the \fBrofi-script(5)\fP manpage
for more information about this syntax. for more information about this syntax.
.PP .PP
\fB\fC\-sep\fR \fIseparator\fP \fB\fC-sep\fR \fIseparator\fP
.PP .PP
Separator for \fB\fCdmenu\fR\&. Example: To show a list of 'a' to 'e' with '|' as a separator: Separator for \fB\fCdmenu\fR\&. Example: To show a list of 'a' to 'e' with '|' as a separator:
@ -74,13 +74,13 @@ Separator for \fB\fCdmenu\fR\&. Example: To show a list of 'a' to 'e' with '|' a
.RS .RS
.nf .nf
echo "a|b|c|d|e" | rofi \-sep '|' \-dmenu echo "a|b|c|d|e" | rofi -sep '|' -dmenu
.fi .fi
.RE .RE
.PP .PP
\fB\fC\-p\fR \fIprompt\fP \fB\fC-p\fR \fIprompt\fP
.PP .PP
Specify the prompt to show in \fB\fCdmenu\fR mode. For example, select 'monkey', a,b,c,d, or e. Specify the prompt to show in \fB\fCdmenu\fR mode. For example, select 'monkey', a,b,c,d, or e.
@ -89,7 +89,7 @@ Specify the prompt to show in \fB\fCdmenu\fR mode. For example, select 'monkey',
.RS .RS
.nf .nf
echo "a|b|c|d|e" | rofi \-sep '|' \-dmenu \-p "monkey" echo "a|b|c|d|e" | rofi -sep '|' -dmenu -p "monkey"
.fi .fi
.RE .RE
@ -98,7 +98,7 @@ echo "a|b|c|d|e" | rofi \-sep '|' \-dmenu \-p "monkey"
Default: \fIdmenu\fP Default: \fIdmenu\fP
.PP .PP
\fB\fC\-l\fR \fInumber of lines to show\fP \fB\fC-l\fR \fInumber of lines to show\fP
.PP .PP
Maximum number of lines the menu may show before scrolling. Maximum number of lines the menu may show before scrolling.
@ -107,7 +107,7 @@ Maximum number of lines the menu may show before scrolling.
.RS .RS
.nf .nf
rofi \-dmenu \-l 25 rofi -dmenu -l 25
.fi .fi
.RE .RE
@ -116,39 +116,39 @@ rofi \-dmenu \-l 25
Default: \fI15\fP Default: \fI15\fP
.PP .PP
\fB\fC\-i\fR \fB\fC-i\fR
.PP .PP
Makes \fB\fCdmenu\fR searches case\-insensitive Makes \fB\fCdmenu\fR searches case-insensitive
.PP .PP
\fB\fC\-a\fR \fIX\fP \fB\fC-a\fR \fIX\fP
.PP .PP
Active row, mark \fIX\fP as active. Where \fIX\fP is a comma\-separated list of python(1)\-style indices and ranges, e.g. indices start at 0, \-1 refers to the last row with \-2 preceding it, ranges are left\-open and right\-close, and so on. You can specify: Active row, mark \fIX\fP as active. Where \fIX\fP is a comma-separated list of python(1)-style indices and ranges, e.g. indices start at 0, -1 refers to the last row with -2 preceding it, ranges are left-open and right-close, and so on. You can specify:
.RS .RS
.IP \(bu 2 .IP \(bu 2
A single row: '5' A single row: '5'
.IP \(bu 2 .IP \(bu 2
A range of (last 3) rows: '\-3:' A range of (last 3) rows: '-3:'
.IP \(bu 2 .IP \(bu 2
4 rows starting from row 7: '7:11' (or in legacy notation: '7\-10') 4 rows starting from row 7: '7:11' (or in legacy notation: '7-10')
.IP \(bu 2 .IP \(bu 2
A set of rows: '2,0,\-9' A set of rows: '2,0,-9'
.IP \(bu 2 .IP \(bu 2
Or any combination: '5,\-3:,7:11,2,0,\-9' Or any combination: '5,-3:,7:11,2,0,-9'
.RE .RE
.PP .PP
\fB\fC\-u\fR \fIX\fP \fB\fC-u\fR \fIX\fP
.PP .PP
Urgent row, mark \fIX\fP as urgent. See \fB\fC\-a\fR option for details. Urgent row, mark \fIX\fP as urgent. See \fB\fC-a\fR option for details.
.PP .PP
\fB\fC\-only\-match\fR \fB\fC-only-match\fR
.PP .PP
Only return a selected item, do not allow custom entry. Only return a selected item, do not allow custom entry.
@ -156,14 +156,14 @@ This mode always returns an entry. It will not return if no matching entry is
selected. selected.
.PP .PP
\fB\fC\-no\-custom\fR \fB\fC-no-custom\fR
.PP .PP
Only return a selected item, do not allow custom entry. Only return a selected item, do not allow custom entry.
This mode returns directly when no entries given. This mode returns directly when no entries given.
.PP .PP
\fB\fC\-format\fR \fIformat\fP \fB\fC-format\fR \fIformat\fP
.PP .PP
Allows the output of dmenu to be customized (N is the total number of input entries): Allows the output of dmenu to be customized (N is the total number of input entries):
@ -172,9 +172,9 @@ Allows the output of dmenu to be customized (N is the total number of input entr
.IP \(bu 2 .IP \(bu 2
\&'s' selected string \&'s' selected string
.IP \(bu 2 .IP \(bu 2
\&'i' index (0 \-\& (N\-\&1)) \&'i' index (0 - (N-1))
.IP \(bu 2 .IP \(bu 2
\&'d' index (1 \-\& N) \&'d' index (1 - N)
.IP \(bu 2 .IP \(bu 2
\&'q' quote string \&'q' quote string
.IP \(bu 2 .IP \(bu 2
@ -190,13 +190,13 @@ Allows the output of dmenu to be customized (N is the total number of input entr
Default: 's' Default: 's'
.PP .PP
\fB\fC\-select\fR \fIstring\fP \fB\fC-select\fR \fIstring\fP
.PP .PP
Select first line that matches the given string Select first line that matches the given string
.PP .PP
\fB\fC\-mesg\fR \fIstring\fP \fB\fC-mesg\fR \fIstring\fP
.PP .PP
Add a message line below the filter entry box. Supports Pango markup. Add a message line below the filter entry box. Supports Pango markup.
@ -204,27 +204,27 @@ For more information on supported markup, see here
\[la]https://docs.gtk.org/Pango/pango_markup.html\[ra] \[la]https://docs.gtk.org/Pango/pango_markup.html\[ra]
.PP .PP
\fB\fC\-dump\fR \fB\fC-dump\fR
.PP .PP
Dump the filtered list to stdout and quit. Dump the filtered list to stdout and quit.
This can be used to get the list as \fBrofi\fP would filter it. This can be used to get the list as \fBrofi\fP would filter it.
Use together with \fB\fC\-filter\fR command. Use together with \fB\fC-filter\fR command.
.PP .PP
\fB\fC\-input\fR \fIfile\fP \fB\fC-input\fR \fIfile\fP
.PP .PP
Reads from \fIfile\fP instead of stdin. Reads from \fIfile\fP instead of stdin.
.PP .PP
\fB\fC\-password\fR \fB\fC-password\fR
.PP .PP
Hide the input text. This should not be considered secure! Hide the input text. This should not be considered secure!
.PP .PP
\fB\fC\-markup\-rows\fR \fB\fC-markup-rows\fR
.PP .PP
Tell \fBrofi\fP that DMenu input is Pango markup encoded, and should be rendered. Tell \fBrofi\fP that DMenu input is Pango markup encoded, and should be rendered.
@ -232,23 +232,23 @@ See here
\[la]https://developer.gnome.org/pygtk/stable/pango-markup-language.html\[ra] for details about Pango markup. \[la]https://developer.gnome.org/pygtk/stable/pango-markup-language.html\[ra] for details about Pango markup.
.PP .PP
\fB\fC\-multi\-select\fR \fB\fC-multi-select\fR
.PP .PP
Allow multiple lines to be selected. Adds a small selection indicator to the left of each entry. Allow multiple lines to be selected. Adds a small selection indicator to the left of each entry.
.PP .PP
\fB\fC\-sync\fR \fB\fC-sync\fR
.PP .PP
Force \fBrofi\fP mode to first read all data from stdin before showing the selection window. This is original dmenu behavior. Force \fBrofi\fP mode to first read all data from stdin before showing the selection window. This is original dmenu behavior.
.PP .PP
Note: the default asynchronous mode will also be automatically disabled if used with conflicting options, Note: the default asynchronous mode will also be automatically disabled if used with conflicting options,
such as \fB\fC\-dump\fR, \fB\fC\-only\-match\fR or \fB\fC\-auto\-select\fR\&. such as \fB\fC-dump\fR, \fB\fC-only-match\fR or \fB\fC-auto-select\fR\&.
.PP .PP
\fB\fC\-async\-pre\-read\fR \fInumber\fP \fB\fC-async-pre-read\fR \fInumber\fP
.PP .PP
Reads the first \fInumber\fP entries blocking, then switches to async mode. Reads the first \fInumber\fP entries blocking, then switches to async mode.
@ -258,31 +258,31 @@ This makes it feel more 'snappy'.
\fIdefault\fP: 25 \fIdefault\fP: 25
.PP .PP
\fB\fC\-window\-title\fR \fItitle\fP \fB\fC-window-title\fR \fItitle\fP
.PP .PP
Set name used for the window title. Will be shown as Rofi \- \fItitle\fP Set name used for the window title. Will be shown as Rofi - \fItitle\fP
.PP .PP
\fB\fC\-w\fR \fIwindowid\fP \fB\fC-w\fR \fIwindowid\fP
.PP .PP
Position \fBrofi\fP over the window with the given X11 window ID. Position \fBrofi\fP over the window with the given X11 window ID.
.PP .PP
\fB\fC\-keep\-right\fR \fB\fC-keep-right\fR
.PP .PP
Set ellipsize mode to start. So, the end of the string is visible. Set ellipsize mode to start. So, the end of the string is visible.
.PP .PP
\fB\fC\-display\-columns\fR \fB\fC-display-columns\fR
.PP .PP
A comma seperated list of columns to show. A comma seperated list of columns to show.
.PP .PP
\fB\fC\-display\-column\-separator\fR \fB\fC-display-column-separator\fR
.PP .PP
The column separator. This is a regex. The column separator. This is a regex.
@ -297,13 +297,13 @@ The column separator. This is a regex.
.IP \(bu 2 .IP \(bu 2
\fB1\fP: User cancelled the selection. \fB1\fP: User cancelled the selection.
.IP \(bu 2 .IP \(bu 2
\fB10\-28\fP: Row accepted by custom keybinding. \fB10-28\fP: Row accepted by custom keybinding.
.RE .RE
.SH SEE ALSO .SH SEE ALSO
.PP .PP
rofi(1), rofi\-sensible\-terminal(1), dmenu(1), rofi\-theme(5), rofi\-script(5), rofi\-theme\-selector(1) rofi(1), rofi-sensible-terminal(1), dmenu(1), rofi-theme(5), rofi-script(5), rofi-theme-selector(1)
.SH AUTHOR .SH AUTHOR
.PP .PP

192
doc/rofi-keys.5
View file

@ -1,8 +1,8 @@
.nh .nh
.TH ROFI\-KEYS 5 rofi\-keys .TH ROFI-KEYS 5 rofi-keys
.SH NAME .SH NAME
.PP .PP
\fBrofi keys\fP \- Rofi Key and Mouse bindings \fBrofi keys\fP - Rofi Key and Mouse bindings
.SH DESCRIPTION .SH DESCRIPTION
.PP .PP
@ -10,13 +10,13 @@
.SH Setting binding .SH Setting binding
.PP .PP
Bindings can be done on the commandline (\-{bindingname}): Bindings can be done on the commandline (-{bindingname}):
.PP .PP
.RS .RS
.nf .nf
rofi \-show run \-kb\-accept\-entry 'Control+Shift+space' rofi -show run -kb-accept-entry 'Control+Shift+space'
.fi .fi
.RE .RE
@ -29,7 +29,7 @@ or via the configuration file:
.nf .nf
configuration { configuration {
kb\-accept\-entry: "Control+Shift+space"; kb-accept-entry: "Control+Shift+space";
} }
.fi .fi
@ -43,7 +43,7 @@ The key can be set by its name (see above) or its keycode:
.nf .nf
configuration { configuration {
kb\-accept\-entry: "Control+Shift+[65]"; kb-accept-entry: "Control+Shift+[65]";
} }
.fi .fi
@ -60,7 +60,7 @@ Multiple keys can be specified for an action as a comma separated list:
.nf .nf
configuration { configuration {
kb\-accept\-entry: "Control+Shift+space,Return"; kb-accept-entry: "Control+Shift+space,Return";
} }
.fi .fi
@ -75,490 +75,490 @@ prepend the binding with \fB\fC!\fR:
.nf .nf
configuration { configuration {
kb\-accept\-entry: "!Control+Shift+space,Return"; kb-accept-entry: "!Control+Shift+space,Return";
} }
.fi .fi
.RE .RE
.SH Keyboard Bindings .SH Keyboard Bindings
.SS \fBkb\-primary\-paste\fP: .SS \fBkb-primary-paste\fP:
.PP .PP
Paste primary selection Paste primary selection
.PP .PP
\fBDefault\fP: Control+V,Shift+Insert \fBDefault\fP: Control+V,Shift+Insert
.SS \fBkb\-secondary\-paste\fP .SS \fBkb-secondary-paste\fP
.PP .PP
Paste clipboard Paste clipboard
.PP .PP
\fBDefault\fP: Control+v,Insert \fBDefault\fP: Control+v,Insert
.SS \fBkb\-clear\-line\fP .SS \fBkb-clear-line\fP
.PP .PP
Clear input line Clear input line
.PP .PP
\fBDefault\fP: Control+w \fBDefault\fP: Control+w
.SS \fBkb\-move\-front\fP .SS \fBkb-move-front\fP
.PP .PP
Beginning of line Beginning of line
.PP .PP
\fBDefault\fP: Control+a \fBDefault\fP: Control+a
.SS \fBkb\-move\-end\fP .SS \fBkb-move-end\fP
.PP .PP
End of line End of line
.PP .PP
\fBDefault\fP: Control+e \fBDefault\fP: Control+e
.SS \fBkb\-move\-word\-back\fP .SS \fBkb-move-word-back\fP
.PP .PP
Move back one word Move back one word
.PP .PP
\fBDefault\fP: Alt+b,Control+Left \fBDefault\fP: Alt+b,Control+Left
.SS \fBkb\-move\-word\-forward\fP .SS \fBkb-move-word-forward\fP
.PP .PP
Move forward one word Move forward one word
.PP .PP
\fBDefault\fP: Alt+f,Control+Right \fBDefault\fP: Alt+f,Control+Right
.SS \fBkb\-move\-char\-back\fP .SS \fBkb-move-char-back\fP
.PP .PP
Move back one char Move back one char
.PP .PP
\fBDefault\fP: Left,Control+b \fBDefault\fP: Left,Control+b
.SS \fBkb\-move\-char\-forward\fP .SS \fBkb-move-char-forward\fP
.PP .PP
Move forward one char Move forward one char
.PP .PP
\fBDefault\fP: Right,Control+f \fBDefault\fP: Right,Control+f
.SS \fBkb\-remove\-word\-back\fP .SS \fBkb-remove-word-back\fP
.PP .PP
Delete previous word Delete previous word
.PP .PP
\fBDefault\fP: Control+Alt+h,Control+BackSpace \fBDefault\fP: Control+Alt+h,Control+BackSpace
.SS \fBkb\-remove\-word\-forward\fP .SS \fBkb-remove-word-forward\fP
.PP .PP
Delete next word Delete next word
.PP .PP
\fBDefault\fP: Control+Alt+d \fBDefault\fP: Control+Alt+d
.SS \fBkb\-remove\-char\-forward\fP .SS \fBkb-remove-char-forward\fP
.PP .PP
Delete next char Delete next char
.PP .PP
\fBDefault\fP: Delete,Control+d \fBDefault\fP: Delete,Control+d
.SS \fBkb\-remove\-char\-back\fP .SS \fBkb-remove-char-back\fP
.PP .PP
Delete previous char Delete previous char
.PP .PP
\fBDefault\fP: BackSpace,Shift+BackSpace,Control+h \fBDefault\fP: BackSpace,Shift+BackSpace,Control+h
.SS \fBkb\-remove\-to\-eol\fP .SS \fBkb-remove-to-eol\fP
.PP .PP
Delete till the end of line Delete till the end of line
.PP .PP
\fBDefault\fP: Control+k \fBDefault\fP: Control+k
.SS \fBkb\-remove\-to\-sol\fP .SS \fBkb-remove-to-sol\fP
.PP .PP
Delete till the start of line Delete till the start of line
.PP .PP
\fBDefault\fP: Control+u \fBDefault\fP: Control+u
.SS \fBkb\-accept\-entry\fP .SS \fBkb-accept-entry\fP
.PP .PP
Accept entry Accept entry
.PP .PP
\fBDefault\fP: Control+j,Control+m,Return,KP\_Enter \fBDefault\fP: Control+j,Control+m,Return,KP_Enter
.SS \fBkb\-accept\-custom\fP .SS \fBkb-accept-custom\fP
.PP .PP
Use entered text as command (in ssh/run modes) Use entered text as command (in ssh/run modes)
.PP .PP
\fBDefault\fP: Control+Return \fBDefault\fP: Control+Return
.SS \fBkb\-accept\-custom\-alt\fP .SS \fBkb-accept-custom-alt\fP
.PP .PP
Use entered text as command (in ssh/run modes) Use entered text as command (in ssh/run modes)
.PP .PP
\fBDefault\fP: Control+Shift+Return \fBDefault\fP: Control+Shift+Return
.SS \fBkb\-accept\-alt\fP .SS \fBkb-accept-alt\fP
.PP .PP
Use alternate accept command. Use alternate accept command.
.PP .PP
\fBDefault\fP: Shift+Return \fBDefault\fP: Shift+Return
.SS \fBkb\-delete\-entry\fP .SS \fBkb-delete-entry\fP
.PP .PP
Delete entry from history Delete entry from history
.PP .PP
\fBDefault\fP: Shift+Delete \fBDefault\fP: Shift+Delete
.SS \fBkb\-mode\-next\fP .SS \fBkb-mode-next\fP
.PP .PP
Switch to the next mode. Switch to the next mode.
.PP .PP
\fBDefault\fP: Shift+Right,Control+Tab \fBDefault\fP: Shift+Right,Control+Tab
.SS \fBkb\-mode\-previous\fP .SS \fBkb-mode-previous\fP
.PP .PP
Switch to the previous mode. Switch to the previous mode.
.PP .PP
\fBDefault\fP: Shift+Left,Control+ISO\_Left\_Tab \fBDefault\fP: Shift+Left,Control+ISO_Left_Tab
.SS \fBkb\-mode\-complete\fP .SS \fBkb-mode-complete\fP
.PP .PP
Start completion for mode. Start completion for mode.
.PP .PP
\fBDefault\fP: Control+l \fBDefault\fP: Control+l
.SS \fBkb\-row\-left\fP .SS \fBkb-row-left\fP
.PP .PP
Go to the previous column Go to the previous column
.PP .PP
\fBDefault\fP: Control+Page\_Up \fBDefault\fP: Control+Page_Up
.SS \fBkb\-row\-right\fP .SS \fBkb-row-right\fP
.PP .PP
Go to the next column Go to the next column
.PP .PP
\fBDefault\fP: Control+Page\_Down \fBDefault\fP: Control+Page_Down
.SS \fBkb\-row\-up\fP .SS \fBkb-row-up\fP
.PP .PP
Select previous entry Select previous entry
.PP .PP
\fBDefault\fP: Up,Control+p \fBDefault\fP: Up,Control+p
.SS \fBkb\-row\-down\fP .SS \fBkb-row-down\fP
.PP .PP
Select next entry Select next entry
.PP .PP
\fBDefault\fP: Down,Control+n \fBDefault\fP: Down,Control+n
.SS \fBkb\-row\-tab\fP .SS \fBkb-row-tab\fP
.PP .PP
Go to next row, if one left, accept it, if no left next mode. Go to next row, if one left, accept it, if no left next mode.
.PP .PP
\fBDefault\fP: \fBDefault\fP:
.SS \fBkb\-element\-next\fP .SS \fBkb-element-next\fP
.PP .PP
Go to next row. Go to next row.
.PP .PP
\fBDefault\fP: Tab \fBDefault\fP: Tab
.SS \fBkb\-element\-prev\fP .SS \fBkb-element-prev\fP
.PP .PP
Go to previous row. Go to previous row.
.PP .PP
\fBDefault\fP: ISO\_Left\_Tab \fBDefault\fP: ISO_Left_Tab
.SS \fBkb\-page\-prev\fP .SS \fBkb-page-prev\fP
.PP .PP
Go to the previous page Go to the previous page
.PP .PP
\fBDefault\fP: Page\_Up \fBDefault\fP: Page_Up
.SS \fBkb\-page\-next\fP .SS \fBkb-page-next\fP
.PP .PP
Go to the next page Go to the next page
.PP .PP
\fBDefault\fP: Page\_Down \fBDefault\fP: Page_Down
.SS \fBkb\-row\-first\fP .SS \fBkb-row-first\fP
.PP .PP
Go to the first entry Go to the first entry
.PP .PP
\fBDefault\fP: Home,KP\_Home \fBDefault\fP: Home,KP_Home
.SS \fBkb\-row\-last\fP .SS \fBkb-row-last\fP
.PP .PP
Go to the last entry Go to the last entry
.PP .PP
\fBDefault\fP: End,KP\_End \fBDefault\fP: End,KP_End
.SS \fBkb\-row\-select\fP .SS \fBkb-row-select\fP
.PP .PP
Set selected item as input text Set selected item as input text
.PP .PP
\fBDefault\fP: Control+space \fBDefault\fP: Control+space
.SS \fBkb\-screenshot\fP .SS \fBkb-screenshot\fP
.PP .PP
Take a screenshot of the rofi window Take a screenshot of the rofi window
.PP .PP
\fBDefault\fP: Alt+S \fBDefault\fP: Alt+S
.SS \fBkb\-ellipsize\fP .SS \fBkb-ellipsize\fP
.PP .PP
Toggle between ellipsize modes for displayed data Toggle between ellipsize modes for displayed data
.PP .PP
\fBDefault\fP: Alt+period \fBDefault\fP: Alt+period
.SS \fBkb\-toggle\-case\-sensitivity\fP .SS \fBkb-toggle-case-sensitivity\fP
.PP .PP
Toggle case sensitivity Toggle case sensitivity
.PP .PP
\fBDefault\fP: grave,dead\_grave \fBDefault\fP: grave,dead_grave
.SS \fBkb\-toggle\-sort\fP .SS \fBkb-toggle-sort\fP
.PP .PP
Toggle sort Toggle sort
.PP .PP
\fBDefault\fP: Alt+grave \fBDefault\fP: Alt+grave
.SS \fBkb\-cancel\fP .SS \fBkb-cancel\fP
.PP .PP
Quit rofi Quit rofi
.PP .PP
\fBDefault\fP: Escape,Control+g,Control+bracketleft \fBDefault\fP: Escape,Control+g,Control+bracketleft
.SS \fBkb\-custom\-1\fP .SS \fBkb-custom-1\fP
.PP .PP
Custom keybinding 1 Custom keybinding 1
.PP .PP
\fBDefault\fP: Alt+1 \fBDefault\fP: Alt+1
.SS \fBkb\-custom\-2\fP .SS \fBkb-custom-2\fP
.PP .PP
Custom keybinding 2 Custom keybinding 2
.PP .PP
\fBDefault\fP: Alt+2 \fBDefault\fP: Alt+2
.SS \fBkb\-custom\-3\fP .SS \fBkb-custom-3\fP
.PP .PP
Custom keybinding 3 Custom keybinding 3
.PP .PP
\fBDefault\fP: Alt+3 \fBDefault\fP: Alt+3
.SS \fBkb\-custom\-4\fP .SS \fBkb-custom-4\fP
.PP .PP
Custom keybinding 4 Custom keybinding 4
.PP .PP
\fBDefault\fP: Alt+4 \fBDefault\fP: Alt+4
.SS \fBkb\-custom\-5\fP .SS \fBkb-custom-5\fP
.PP .PP
Custom Keybinding 5 Custom Keybinding 5
.PP .PP
\fBDefault\fP: Alt+5 \fBDefault\fP: Alt+5
.SS \fBkb\-custom\-6\fP .SS \fBkb-custom-6\fP
.PP .PP
Custom keybinding 6 Custom keybinding 6
.PP .PP
\fBDefault\fP: Alt+6 \fBDefault\fP: Alt+6
.SS \fBkb\-custom\-7\fP .SS \fBkb-custom-7\fP
.PP .PP
Custom Keybinding 7 Custom Keybinding 7
.PP .PP
\fBDefault\fP: Alt+7 \fBDefault\fP: Alt+7
.SS \fBkb\-custom\-8\fP .SS \fBkb-custom-8\fP
.PP .PP
Custom keybinding 8 Custom keybinding 8
.PP .PP
\fBDefault\fP: Alt+8 \fBDefault\fP: Alt+8
.SS \fBkb\-custom\-9\fP .SS \fBkb-custom-9\fP
.PP .PP
Custom keybinding 9 Custom keybinding 9
.PP .PP
\fBDefault\fP: Alt+9 \fBDefault\fP: Alt+9
.SS \fBkb\-custom\-10\fP .SS \fBkb-custom-10\fP
.PP .PP
Custom keybinding 10 Custom keybinding 10
.PP .PP
\fBDefault\fP: Alt+0 \fBDefault\fP: Alt+0
.SS \fBkb\-custom\-11\fP .SS \fBkb-custom-11\fP
.PP .PP
Custom keybinding 11 Custom keybinding 11
.PP .PP
\fBDefault\fP: Alt+exclam \fBDefault\fP: Alt+exclam
.SS \fBkb\-custom\-12\fP .SS \fBkb-custom-12\fP
.PP .PP
Custom keybinding 12 Custom keybinding 12
.PP .PP
\fBDefault\fP: Alt+at \fBDefault\fP: Alt+at
.SS \fBkb\-custom\-13\fP .SS \fBkb-custom-13\fP
.PP .PP
Custom keybinding 13 Custom keybinding 13
.PP .PP
\fBDefault\fP: Alt+numbersign \fBDefault\fP: Alt+numbersign
.SS \fBkb\-custom\-14\fP .SS \fBkb-custom-14\fP
.PP .PP
Custom keybinding 14 Custom keybinding 14
.PP .PP
\fBDefault\fP: Alt+dollar \fBDefault\fP: Alt+dollar
.SS \fBkb\-custom\-15\fP .SS \fBkb-custom-15\fP
.PP .PP
Custom keybinding 15 Custom keybinding 15
.PP .PP
\fBDefault\fP: Alt+percent \fBDefault\fP: Alt+percent
.SS \fBkb\-custom\-16\fP .SS \fBkb-custom-16\fP
.PP .PP
Custom keybinding 16 Custom keybinding 16
.PP .PP
\fBDefault\fP: Alt+dead\_circumflex \fBDefault\fP: Alt+dead_circumflex
.SS \fBkb\-custom\-17\fP .SS \fBkb-custom-17\fP
.PP .PP
Custom keybinding 17 Custom keybinding 17
.PP .PP
\fBDefault\fP: Alt+ampersand \fBDefault\fP: Alt+ampersand
.SS \fBkb\-custom\-18\fP .SS \fBkb-custom-18\fP
.PP .PP
Custom keybinding 18 Custom keybinding 18
.PP .PP
\fBDefault\fP: Alt+asterisk \fBDefault\fP: Alt+asterisk
.SS \fBkb\-custom\-19\fP .SS \fBkb-custom-19\fP
.PP .PP
Custom Keybinding 19 Custom Keybinding 19
.PP .PP
\fBDefault\fP: Alt+parenleft \fBDefault\fP: Alt+parenleft
.SS \fBkb\-select\-1\fP .SS \fBkb-select-1\fP
.PP .PP
Select row 1 Select row 1
.PP .PP
\fBDefault\fP: Super+1 \fBDefault\fP: Super+1
.SS \fBkb\-select\-2\fP .SS \fBkb-select-2\fP
.PP .PP
Select row 2 Select row 2
.PP .PP
\fBDefault\fP: Super+2 \fBDefault\fP: Super+2
.SS \fBkb\-select\-3\fP .SS \fBkb-select-3\fP
.PP .PP
Select row 3 Select row 3
.PP .PP
\fBDefault\fP: Super+3 \fBDefault\fP: Super+3
.SS \fBkb\-select\-4\fP .SS \fBkb-select-4\fP
.PP .PP
Select row 4 Select row 4
.PP .PP
\fBDefault\fP: Super+4 \fBDefault\fP: Super+4
.SS \fBkb\-select\-5\fP .SS \fBkb-select-5\fP
.PP .PP
Select row 5 Select row 5
.PP .PP
\fBDefault\fP: Super+5 \fBDefault\fP: Super+5
.SS \fBkb\-select\-6\fP .SS \fBkb-select-6\fP
.PP .PP
Select row 6 Select row 6
.PP .PP
\fBDefault\fP: Super+6 \fBDefault\fP: Super+6
.SS \fBkb\-select\-7\fP .SS \fBkb-select-7\fP
.PP .PP
Select row 7 Select row 7
.PP .PP
\fBDefault\fP: Super+7 \fBDefault\fP: Super+7
.SS \fBkb\-select\-8\fP .SS \fBkb-select-8\fP
.PP .PP
Select row 8 Select row 8
.PP .PP
\fBDefault\fP: Super+8 \fBDefault\fP: Super+8
.SS \fBkb\-select\-9\fP .SS \fBkb-select-9\fP
.PP .PP
Select row 9 Select row 9
.PP .PP
\fBDefault\fP: Super+9 \fBDefault\fP: Super+9
.SS \fBkb\-select\-10\fP .SS \fBkb-select-10\fP
.PP .PP
Select row 10 Select row 10
@ -566,49 +566,49 @@ Select row 10
\fBDefault\fP: Super+0 \fBDefault\fP: Super+0
.SH Mouse Bindings .SH Mouse Bindings
.SS \fBml\-row\-left\fP .SS \fBml-row-left\fP
.PP .PP
Go to the previous column Go to the previous column
.PP .PP
\fBDefault\fP: ScrollLeft \fBDefault\fP: ScrollLeft
.SS \fBml\-row\-right\fP .SS \fBml-row-right\fP
.PP .PP
Go to the next column Go to the next column
.PP .PP
\fBDefault\fP: ScrollRight \fBDefault\fP: ScrollRight
.SS \fBml\-row\-up\fP .SS \fBml-row-up\fP
.PP .PP
Select previous entry Select previous entry
.PP .PP
\fBDefault\fP: ScrollUp \fBDefault\fP: ScrollUp
.SS \fBml\-row\-down\fP .SS \fBml-row-down\fP
.PP .PP
Select next entry Select next entry
.PP .PP
\fBDefault\fP: ScrollDown \fBDefault\fP: ScrollDown
.SS \fBme\-select\-entry\fP .SS \fBme-select-entry\fP
.PP .PP
Select hovered row Select hovered row
.PP .PP
\fBDefault\fP: MousePrimary \fBDefault\fP: MousePrimary
.SS \fBme\-accept\-entry\fP .SS \fBme-accept-entry\fP
.PP .PP
Accept hovered row Accept hovered row
.PP .PP
\fBDefault\fP: MouseDPrimary \fBDefault\fP: MouseDPrimary
.SS \fBme\-accept\-custom\fP .SS \fBme-accept-custom\fP
.PP .PP
Accept hovered row with custom action Accept hovered row with custom action
@ -617,7 +617,7 @@ Accept hovered row with custom action
.SH SEE ALSO .SH SEE ALSO
.PP .PP
rofi(1), rofi\-sensible\-terminal(1), rofi\-theme(5), rofi\-script(5) rofi(1), rofi-sensible-terminal(1), rofi-theme(5), rofi-script(5)
.SH AUTHOR .SH AUTHOR
.PP .PP

34
doc/rofi-script.5
View file

@ -1,8 +1,8 @@
.nh .nh
.TH ROFI\-SCRIPT 5 rofi\-script .TH ROFI-SCRIPT 5 rofi-script
.SH NAME .SH NAME
.PP .PP
\fBrofi script mode\fP \- Rofi format for scriptable mode. \fBrofi script mode\fP - Rofi format for scriptable mode.
.SH DESCRIPTION .SH DESCRIPTION
.PP .PP
@ -20,7 +20,7 @@ For example:
.RS .RS
.nf .nf
rofi \-show fb \-modes "fb:file\_browser.sh" rofi -show fb -modes "fb:file_browser.sh"
.fi .fi
.RE .RE
@ -62,7 +62,7 @@ This shows two entries, reload and quit. When the quit entry is selected, rofi c
.PP .PP
Rofi sets the following environment variable when executing the script: Rofi sets the following environment variable when executing the script:
.SS \fB\fCROFI\_RETV\fR .SS \fB\fCROFI_RETV\fR
.PP .PP
An integer number with the current state: An integer number with the current state:
@ -74,15 +74,15 @@ An integer number with the current state:
.IP \(bu 2 .IP \(bu 2
\fB2\fP: Selected a custom entry. \fB2\fP: Selected a custom entry.
.IP \(bu 2 .IP \(bu 2
\fB10\-28\fP: Custom keybinding 1\-19 ( need to be explicitly enabled by script ). \fB10-28\fP: Custom keybinding 1-19 ( need to be explicitly enabled by script ).
.RE .RE
.SS \fB\fCROFI\_INFO\fR .SS \fB\fCROFI_INFO\fR
.PP .PP
Environment get set when selected entry get set with the property value of the 'info' row option, if set. Environment get set when selected entry get set with the property value of the 'info' row option, if set.
.SS \fB\fCROFI\_DATA\fR .SS \fB\fCROFI_DATA\fR
.PP .PP
Environment get set when script sets \fB\fCdata\fR option in header. Environment get set when script sets \fB\fCdata\fR option in header.
@ -98,7 +98,7 @@ For example to set the prompt:
.RS .RS
.nf .nf
echo \-en "\\0prompt\\x1fChange prompt\\n" echo -en "\\0prompt\\x1fChange prompt\\n"
.fi .fi
.RE .RE
@ -112,7 +112,7 @@ The following extra options exists:
.IP \(bu 2 .IP \(bu 2
\fBmessage\fP: Update the message text. \fBmessage\fP: Update the message text.
.IP \(bu 2 .IP \(bu 2
\fBmarkup\-rows\fP: If 'true' renders markup in the row. \fBmarkup-rows\fP: If 'true' renders markup in the row.
.IP \(bu 2 .IP \(bu 2
\fBurgent\fP: Mark rows as urgent. (for syntax see the urgent option in dmenu mode) \fBurgent\fP: Mark rows as urgent. (for syntax see the urgent option in dmenu mode)
.IP \(bu 2 .IP \(bu 2
@ -120,11 +120,11 @@ The following extra options exists:
.IP \(bu 2 .IP \(bu 2
\fBdelim\fP: Set the delimiter for for next rows. Default is '\\n' and this option should finish with this. Only call this on first call of script, it is remembered for consecutive calls. \fBdelim\fP: Set the delimiter for for next rows. Default is '\\n' and this option should finish with this. Only call this on first call of script, it is remembered for consecutive calls.
.IP \(bu 2 .IP \(bu 2
\fBno\-custom\fP: If set to 'true'; only accept listed entries, ignore custom input. \fBno-custom\fP: If set to 'true'; only accept listed entries, ignore custom input.
.IP \(bu 2 .IP \(bu 2
\fBuse\-hot\-keys\fP: If set to true, it enabled the Custom keybindings for script. Warning this breaks the normal rofi flow. \fBuse-hot-keys\fP: If set to true, it enabled the Custom keybindings for script. Warning this breaks the normal rofi flow.
.IP \(bu 2 .IP \(bu 2
\fBdata\fP: Passed data to the next execution of the script via \fBROFI\_DATA\fP\&. \fBdata\fP: Passed data to the next execution of the script via \fBROFI_DATA\fP\&.
.RE .RE
@ -140,7 +140,7 @@ For example:
.RS .RS
.nf .nf
echo \-en "aap\\0icon\\x1ffolder\\n" echo -en "aap\\0icon\\x1ffolder\\n"
.fi .fi
.RE .RE
@ -156,7 +156,7 @@ The following options are supported:
.IP \(bu 2 .IP \(bu 2
\fBnonselectable\fP: If true the row cannot activated. \fBnonselectable\fP: If true the row cannot activated.
.IP \(bu 2 .IP \(bu 2
\fBinfo\fP: Info that, on selection, gets placed in the \fB\fCROFI\_INFO\fR environment variable. This entry does not get searched. \fBinfo\fP: Info that, on selection, gets placed in the \fB\fCROFI_INFO\fR environment variable. This entry does not get searched.
.RE .RE
@ -167,7 +167,7 @@ multiple entries can be passed using the \fB\fC\\x1f\fR separator.
.RS .RS
.nf .nf
echo \-en "aap\\0icon\\x1ffolder\\x1finfo\\x1ftest\\n" echo -en "aap\\0icon\\x1ffolder\\x1finfo\\x1ftest\\n"
.fi .fi
.RE .RE
@ -184,7 +184,7 @@ In bash the best way to do this is using \fB\fCcoproc\fR\&.
.RS .RS
.nf .nf
coproc ( myApp > /dev/null 2>\&1 ) coproc ( myApp > /dev/null 2>&1 )
.fi .fi
.RE .RE
@ -196,7 +196,7 @@ See issue #1201 on github.
.SH SEE ALSO .SH SEE ALSO
.PP .PP
rofi(1), rofi\-sensible\-terminal(1), dmenu(1), rofi\-theme(5), rofi\-theme\-selector(1) rofi(1), rofi-sensible-terminal(1), dmenu(1), rofi-theme(5), rofi-theme-selector(1)
.SH AUTHOR .SH AUTHOR
.PP .PP

20
doc/rofi-sensible-terminal.1
View file

@ -1,18 +1,18 @@
.nh .nh
.TH rofi\-sensible\-terminal 1 rofi\-sensible\-terminal .TH rofi-sensible-terminal 1 rofi-sensible-terminal
.SH NAME .SH NAME
.PP .PP
\fBrofi\-sensible\-terminal\fP \- launches $TERMINAL with fallbacks \fBrofi-sensible-terminal\fP - launches $TERMINAL with fallbacks
.SH SYNOPSIS .SH SYNOPSIS
.PP .PP
rofi\-sensible\-terminal [arguments] rofi-sensible-terminal [arguments]
.SH DESCRIPTION .SH DESCRIPTION
.PP .PP
rofi\-sensible\-terminal is invoked in the rofi default config to start a terminal. This rofi-sensible-terminal is invoked in the rofi default config to start a terminal. This
wrapper script is necessary since there is no distribution\-independent terminal launcher wrapper script is necessary since there is no distribution-independent terminal launcher
(but for example Debian has x\-terminal\-emulator). Distribution packagers are responsible for (but for example Debian has x-terminal-emulator). Distribution packagers are responsible for
shipping this script in a way which is appropriate for the distribution. shipping this script in a way which is appropriate for the distribution.
.PP .PP
@ -20,9 +20,9 @@ It tries to start one of the following (in that order):
.RS .RS
.IP \(bu 2 .IP \(bu 2
\fB\fC$TERMINAL\fR (this is a non\-standard variable) \fB\fC$TERMINAL\fR (this is a non-standard variable)
.IP \(bu 2 .IP \(bu 2
x\-terminal\-emulator x-terminal-emulator
.IP \(bu 2 .IP \(bu 2
urxvt urxvt
.IP \(bu 2 .IP \(bu 2
@ -44,9 +44,9 @@ xterm
.IP \(bu 2 .IP \(bu 2
roxterm roxterm
.IP \(bu 2 .IP \(bu 2
xfce4\-terminal.wrapper xfce4-terminal.wrapper
.IP \(bu 2 .IP \(bu 2
mate\-terminal mate-terminal
.IP \(bu 2 .IP \(bu 2
lxterminal lxterminal
.IP \(bu 2 .IP \(bu 2

20
doc/rofi-theme-selector.1
View file

@ -1,39 +1,39 @@
.nh .nh
.TH rofi\-theme\-selector 1 rofi\-theme\-selector .TH rofi-theme-selector 1 rofi-theme-selector
.SH NAME .SH NAME
.PP .PP
\fBrofi\-theme\-selector\fP \- Preview and apply themes for \fBrofi\fP \fBrofi-theme-selector\fP - Preview and apply themes for \fBrofi\fP
.SH DESCRIPTION .SH DESCRIPTION
.PP .PP
\fBrofi\-theme\-selector\fP is a bash/rofi script to preview and apply themes for \fBrofi\fP\&. \fBrofi-theme-selector\fP is a bash/rofi script to preview and apply themes for \fBrofi\fP\&.
It's part of any installation of \fBrofi\fP\&. It's part of any installation of \fBrofi\fP\&.
.SH USAGE .SH USAGE
.SS Running rofi\-theme\-selector .SS Running rofi-theme-selector
.PP .PP
\fBrofi\-theme\-selector\fP shows a list of all available themes in a \fBrofi\fP window. \fBrofi-theme-selector\fP shows a list of all available themes in a \fBrofi\fP window.
It lets you preview each theme with the Enter key and apply the theme to your It lets you preview each theme with the Enter key and apply the theme to your
\fBrofi\fP configuration file with Alt+a. \fBrofi\fP configuration file with Alt+a.
.SH Theme directories .SH Theme directories
.PP .PP
\fBrofi\-theme\-selector\fP searches the following directories for themes: \fBrofi-theme-selector\fP searches the following directories for themes:
.RS .RS
.IP \(bu 2 .IP \(bu 2
${PREFIX}/share/rofi/themes ${PREFIX}/share/rofi/themes
.IP \(bu 2 .IP \(bu 2
$XDG\_CONFIG\_HOME/rofi/themes $XDG_CONFIG_HOME/rofi/themes
.IP \(bu 2 .IP \(bu 2
$XDG\_DATA\_HOME/share/rofi/themes $XDG_DATA_HOME/share/rofi/themes
.RE .RE
.PP .PP
${PREFIX} reflects the install location of rofi. In most cases this will be "/usr". ${PREFIX} reflects the install location of rofi. In most cases this will be "/usr".
$XDG\_CONFIG\_HOME is normally unset. Default path is "$HOME/.config". $XDG_CONFIG_HOME is normally unset. Default path is "$HOME/.config".
$XDG\_DATA\_HOME is normally unset. Default path is "$HOME/.local/share". $XDG_DATA_HOME is normally unset. Default path is "$HOME/.local/share".
.SH SEE ALSO .SH SEE ALSO
.PP .PP

358
doc/rofi-theme.5
View file

@ -1,8 +1,8 @@
.nh .nh
.TH ROFI\-THEME 5 rofi\-theme .TH ROFI-THEME 5 rofi-theme
.SH NAME .SH NAME
.PP .PP
\fBrofi\-theme\fP \- Rofi theme format files \fBrofi-theme\fP - Rofi theme format files
.SH DEFAULT THEME LOADING .SH DEFAULT THEME LOADING
.PP .PP
@ -37,7 +37,7 @@ To see the default theme, run the following command:
.RS .RS
.nf .nf
rofi \-no\-config \-dump\-theme rofi -no-config -dump-theme
.fi .fi
.RE .RE
@ -47,12 +47,12 @@ rofi \-no\-config \-dump\-theme
The need for a new theme format was motivated by the fact that the way rofi handled widgets has changed. From a very The need for a new theme format was motivated by the fact that the way rofi handled widgets has changed. From a very
static drawing of lines and text to a nice structured form of packing widgets. This change made it possible to provide a static drawing of lines and text to a nice structured form of packing widgets. This change made it possible to provide a
more flexible theme framework. The old theme format and config file are not flexible enough to expose these options in a more flexible theme framework. The old theme format and config file are not flexible enough to expose these options in a
user\-friendly way. Therefore, a new file format has been created, replacing the old one. user-friendly way. Therefore, a new file format has been created, replacing the old one.
.SH FORMAT SPECIFICATION .SH FORMAT SPECIFICATION
.SH Encoding .SH Encoding
.PP .PP
The encoding of the file is utf\-8. Both unix (\fB\fC\\n\fR) and windows (\fB\fC\\r\\n\fR) newlines format are supported. But unix is The encoding of the file is utf-8. Both unix (\fB\fC\\n\fR) and windows (\fB\fC\\r\\n\fR) newlines format are supported. But unix is
preferred. preferred.
.SH Comments .SH Comments
@ -134,7 +134,7 @@ abbreviation for \fBr\fPofi \fBa\fPdvanced \fBs\fPtyle \fBi\fPnformation.
.SH Basic Structure .SH Basic Structure
.PP .PP
Each element has a section with defined properties. Global properties can be defined in section \fB\fC* { }\fR\&. Each element has a section with defined properties. Global properties can be defined in section \fB\fC* { }\fR\&.
Sub\-\&section names begin with a hash symbol \fB\fC#\fR\&. Sub-section names begin with a hash symbol \fB\fC#\fR\&.
.PP .PP
It is advised to define the \fIglobal properties section\fP on top of the file to It is advised to define the \fIglobal properties section\fP on top of the file to
@ -183,7 +183,7 @@ A theme can have multiple element theme sections.
.PP .PP
The element path can consist of multiple names separated by whitespace or dots. The element path can consist of multiple names separated by whitespace or dots.
Each element may contain any number of letters, numbers and \fB\fC\-\fR\&'s. Each element may contain any number of letters, numbers and \fB\fC-\fR\&'s.
The first element in the element path should always start with a \fB\fC#\fR\&. The first element in the element path should always start with a \fB\fC#\fR\&.
Multiple elements can be specified by a \fB\fC,\fR\&. Multiple elements can be specified by a \fB\fC,\fR\&.
@ -195,10 +195,10 @@ This is a valid element name:
.nf .nf
element normal.normal { element normal.normal {
background\-color: blue; background-color: blue;
} }
button { button {
background\-color: blue; background-color: blue;
} }
.fi .fi
@ -212,7 +212,7 @@ And is identical to:
.nf .nf
element normal normal, button { element normal normal, button {
background\-color: blue; background-color: blue;
} }
.fi .fi
@ -278,7 +278,7 @@ Both fields are mandatory for a property.
.PP .PP
The \fB\fCidentifier\fR names the specified property. Identifiers can consist of any The \fB\fCidentifier\fR names the specified property. Identifiers can consist of any
combination of numbers, letters and '\-'. It must not contain any whitespace. combination of numbers, letters and '-'. It must not contain any whitespace.
The structure of the \fB\fCvalue\fR defines the type of the property. The current The structure of the \fB\fCvalue\fR defines the type of the property. The current
parser does not define or enforce a certain type of a particular \fB\fCidentifier\fR\&. parser does not define or enforce a certain type of a particular \fB\fCidentifier\fR\&.
When used, values with the wrong type that cannot be converted are ignored. When used, values with the wrong type that cannot be converted are ignored.
@ -354,12 +354,12 @@ font: "Awasome 12";
.RE .RE
.PP .PP
The string must be valid UTF\-8. The string must be valid UTF-8.
.SH Integer .SH Integer
.RS .RS
.IP \(bu 2 .IP \(bu 2
Format: \fB\fC[\-+]?[:digit:]+\fR Format: \fB\fC[-+]?[:digit:]+\fR
.RE .RE
@ -381,7 +381,7 @@ lines: 12;
.SH Real .SH Real
.RS .RS
.IP \(bu 2 .IP \(bu 2
Format: \fB\fC[\-+]?[:digit:]+(\\.[:digit:]+)?\fR Format: \fB\fC[-+]?[:digit:]+(\\.[:digit:]+)?\fR
.RE .RE
@ -401,7 +401,7 @@ real: 3.4;
.RE .RE
.PP .PP
The following is not valid: \fB\fC\&.3\fR, \fB\fC3.\fR or scientific notation: \fB\fC3.4e\-3\fR\&. The following is not valid: \fB\fC\&.3\fR, \fB\fC3.\fR or scientific notation: \fB\fC3.4e-3\fR\&.
.SH Boolean .SH Boolean
.RS .RS
@ -411,7 +411,7 @@ Format: \fB\fC(true|false)\fR
.RE .RE
.PP .PP
Boolean value is either \fB\fCtrue\fR or \fB\fCfalse\fR\&. This is case\-\&sensitive. Boolean value is either \fB\fCtrue\fR or \fB\fCfalse\fR\&. This is case-sensitive.
.PP .PP
For example: For example:
@ -427,7 +427,7 @@ dynamic: false;
.SH Image .SH Image
.PP .PP
\fBrofi\fP support a limited set of background\-image formats. \fBrofi\fP support a limited set of background-image formats.
.RS .RS
.IP \(bu 2 .IP \(bu 2
@ -436,12 +436,12 @@ Format: url("path to image");
Format: url("path to image", scale); Format: url("path to image", scale);
where scale is: none, both, width, height where scale is: none, both, width, height
.IP \(bu 2 .IP \(bu 2
Format: linear\-gradient(stop color,stop1, color, stop2 color, ...); Format: linear-gradient(stop color,stop1, color, stop2 color, ...);
.IP \(bu 2 .IP \(bu 2
Format: linear\-gradient(to direction, stop color,stop1, color, stop2 color, ...); Format: linear-gradient(to direction, stop color,stop1, color, stop2 color, ...);
where direction is: top,left,right,bottom. where direction is: top,left,right,bottom.
.IP \(bu 2 .IP \(bu 2
Format: linear\-gradient(angle, stop color,stop1, color, stop2 color, ...); Format: linear-gradient(angle, stop color,stop1, color, stop2 color, ...);
Angle in deg,rad,grad (as used in color). Angle in deg,rad,grad (as used in color).
.RE .RE
@ -473,27 +473,27 @@ Format: \fB\fChwb[a]( {ANGLE}, {PERCENTAGE}, {PERCENTAGE} [, {PERCENTAGE}])\fR
.IP \(bu 2 .IP \(bu 2
Format: \fB\fCcmyk( {PERCENTAGE}, {PERCENTAGE}, {PERCENTAGE}, {PERCENTAGE} [, {PERCENTAGE} ])\fR Format: \fB\fCcmyk( {PERCENTAGE}, {PERCENTAGE}, {PERCENTAGE}, {PERCENTAGE} [, {PERCENTAGE} ])\fR
.IP \(bu 2 .IP \(bu 2
Format: \fB\fC{named\-color} [ / {PERCENTAGE} ]\fR Format: \fB\fC{named-color} [ / {PERCENTAGE} ]\fR
.RE .RE
.PP .PP
The white\-space format proposed in CSS4 is also supported. The white-space format proposed in CSS4 is also supported.
.PP .PP
The different values are: The different values are:
.RS .RS
.IP \(bu 2 .IP \(bu 2
\fB\fC{HEX}\fR is a hexadecimal number ('0\-9a\-f' case insensitive). \fB\fC{HEX}\fR is a hexadecimal number ('0-9a-f' case insensitive).
.IP \(bu 2 .IP \(bu 2
\fB\fC{INTEGER}\fR value can be between 0 and 255 or 0\-100 when representing percentage. \fB\fC{INTEGER}\fR value can be between 0 and 255 or 0-100 when representing percentage.
.IP \(bu 2 .IP \(bu 2
\fB\fC{ANGLE}\fR is the angle on the color wheel, can be in \fB\fCdeg\fR, \fB\fCrad\fR, \fB\fCgrad\fR or \fB\fCturn\fR\&. When no unit is specified, degrees is assumed. \fB\fC{ANGLE}\fR is the angle on the color wheel, can be in \fB\fCdeg\fR, \fB\fCrad\fR, \fB\fCgrad\fR or \fB\fCturn\fR\&. When no unit is specified, degrees is assumed.
.IP \(bu 2 .IP \(bu 2
\fB\fC{PERCENTAGE}\fR can be between 0\-1.0, or 0%\-100% \fB\fC{PERCENTAGE}\fR can be between 0-1.0, or 0%-100%
.IP \(bu 2 .IP \(bu 2
\fB\fC{named\-color}\fR is one of the following colors:AliceBlue, AntiqueWhite, Aqua, Aquamarine, Azure, Beige, Bisque, Black, BlanchedAlmond, Blue, BlueViolet, Brown, \fB\fC{named-color}\fR is one of the following colors:AliceBlue, AntiqueWhite, Aqua, Aquamarine, Azure, Beige, Bisque, Black, BlanchedAlmond, Blue, BlueViolet, Brown,
BurlyWood, CadetBlue, Chartreuse, Chocolate, Coral, CornflowerBlue, Cornsilk, Crimson, Cyan, DarkBlue, DarkCyan, BurlyWood, CadetBlue, Chartreuse, Chocolate, Coral, CornflowerBlue, Cornsilk, Crimson, Cyan, DarkBlue, DarkCyan,
DarkGoldenRod, DarkGray, DarkGrey, DarkGreen, DarkKhaki, DarkMagenta, DarkOliveGreen, DarkOrange, DarkOrchid, DarkRed, DarkGoldenRod, DarkGray, DarkGrey, DarkGreen, DarkKhaki, DarkMagenta, DarkOliveGreen, DarkOrange, DarkOrchid, DarkRed,
DarkSalmon, DarkSeaGreen, DarkSlateBlue, DarkSlateGray, DarkSlateGrey, DarkTurquoise, DarkViolet, DeepPink, DeepSkyBlue, DarkSalmon, DarkSeaGreen, DarkSlateBlue, DarkSlateGray, DarkSlateGrey, DarkTurquoise, DarkViolet, DeepPink, DeepSkyBlue,
@ -517,9 +517,9 @@ For example:
.RS .RS
.nf .nf
background\-color: #FF0000; background-color: #FF0000;
border\-color: rgba(0,0,1, 0.5); border-color: rgba(0,0,1, 0.5);
text\-color: SeaGreen; text-color: SeaGreen;
.fi .fi
.RE .RE
@ -531,8 +531,8 @@ or
.RS .RS
.nf .nf
background\-color: transparent; background-color: transparent;
text\-color: Black; text-color: Black;
.fi .fi
.RE .RE
@ -620,7 +620,7 @@ For example:
.RE .RE
.PP .PP
On a full\-HD (1920x1080) monitor, it defines a padding of 192 pixels on the left On a full-HD (1920x1080) monitor, it defines a padding of 192 pixels on the left
and right side and 108 pixels on the top and bottom. and right side and 108 pixels on the top and bottom.
.SS Calculating sizes .SS Calculating sizes
@ -631,7 +631,7 @@ Rofi supports some maths in calculating sizes. For this it uses the CSS syntax:
.RS .RS
.nf .nf
width: calc( 100% \- 37px ); width: calc( 100% - 37px );
.fi .fi
.RE .RE
@ -643,7 +643,7 @@ It supports the following operations:
.IP \(bu 2 .IP \(bu 2
\fB\fC+\fR : Add \fB\fC+\fR : Add
.IP \(bu 2 .IP \(bu 2
\fB\fC\-\fR : Subtract \fB\fC-\fR : Subtract
.IP \(bu 2 .IP \(bu 2
\fB\fC/\fR : Divide \fB\fC/\fR : Divide
.IP \(bu 2 .IP \(bu 2
@ -691,9 +691,9 @@ The different number of fields in the formats are parsed like:
.IP \(bu 2 .IP \(bu 2
1 field: \fB\fCall\fR 1 field: \fB\fCall\fR
.IP \(bu 2 .IP \(bu 2
2 fields: \fB\fCtop\&bottom\fR \fB\fCleft\&right\fR 2 fields: \fB\fCtop&bottom\fR \fB\fCleft&right\fR
.IP \(bu 2 .IP \(bu 2
3 fields: \fB\fCtop\fR, \fB\fCleft\&right\fR, \fB\fCbottom\fR 3 fields: \fB\fCtop\fR, \fB\fCleft&right\fR, \fB\fCbottom\fR
.IP \(bu 2 .IP \(bu 2
4 fields: \fB\fCtop\fR, \fB\fCright\fR, \fB\fCbottom\fR, \fB\fCleft\fR 4 fields: \fB\fCtop\fR, \fB\fCright\fR, \fB\fCbottom\fR, \fB\fCleft\fR
@ -743,9 +743,9 @@ Indicate a place on the window/monitor.
Format: \fB\fC(center|east|north|west|south|north east|north west|south west|south east)\fR Format: \fB\fC(center|east|north|west|south|north east|north west|south west|south east)\fR
\fB\fC \fB\fC
north west | north | north east north west | north | north east
\-\-\-\-\-\-\-\-\-\-\-\-\-|\-\-\-\-\-\-\-\-\-\-\-\-\-|\-\-\-\-\-\-\-\-\-\-\-\- -------------|-------------|------------
west | center | east west | center | east
\-\-\-\-\-\-\-\-\-\-\-\-\-|\-\-\-\-\-\-\-\-\-\-\-\-\-|\-\-\-\-\-\-\-\-\-\-\-\- -------------|-------------|------------
south west | south | south east south west | south | south east
\fR \fR
@ -855,7 +855,7 @@ Format: \fB\fC[ keyword, keyword ]\fR
.RE .RE
.PP .PP
A list starts with a '[' and ends with a ']'. The entries in the list are comma\-separated. A list starts with a '[' and ends with a ']'. The entries in the list are comma-separated.
The \fB\fCkeyword\fR in the list refers to an widget name. The \fB\fCkeyword\fR in the list refers to an widget name.
.SH List of values .SH List of values
@ -866,7 +866,7 @@ Format: \fB\fC[ value, value, ... ]\fR
.RE .RE
.PP .PP
An list starts with a '[' and ends with a ']'. The entries in the list are comma\-separated. An list starts with a '[' and ends with a ']'. The entries in the list are comma-separated.
.SH Environment variable .SH Environment variable
.RS .RS
@ -877,14 +877,14 @@ Format: \fB\fC${:alnum:}\fR
.PP .PP
This will parse the environment variable as the property value. (that then can be any of the above types). This will parse the environment variable as the property value. (that then can be any of the above types).
The environment variable should be an alphanumeric string without white\-space. The environment variable should be an alphanumeric string without white-space.
.PP .PP
.RS .RS
.nf .nf
* { * {
background\-color: ${BG}; background-color: ${BG};
} }
.fi .fi
@ -898,7 +898,7 @@ Format: \fB\fCenv(ENVIRONMENT, default)\fR
.PP .PP
This will parse the environment variable as the property value. (that then can be any of the above types). This will parse the environment variable as the property value. (that then can be any of the above types).
The environment variable should be an alphanumeric string without white\-space. The environment variable should be an alphanumeric string without white-space.
If the environment value is not found, the default value is used. If the environment value is not found, the default value is used.
.PP .PP
@ -930,7 +930,7 @@ Inherits the property from its parent widget.
.nf .nf
mainbox { mainbox {
border\-color: inherit; border-color: inherit;
} }
.fi .fi
@ -993,15 +993,15 @@ The current widgets available in \fBrofi\fP:
.IP \(bu 2 .IP \(bu 2
\fB\fCbox\fR: the horizontal @box packing the widgets \fB\fCbox\fR: the horizontal @box packing the widgets
.IP \(bu 2 .IP \(bu 2
\fB\fCcase\-indicator\fR: the case/sort indicator @textbox \fB\fCcase-indicator\fR: the case/sort indicator @textbox
.IP \(bu 2 .IP \(bu 2
\fB\fCprompt\fR: the prompt @textbox \fB\fCprompt\fR: the prompt @textbox
.IP \(bu 2 .IP \(bu 2
\fB\fCentry\fR: the main entry @textbox \fB\fCentry\fR: the main entry @textbox
.IP \(bu 2 .IP \(bu 2
\fB\fCnum\-rows\fR: Shows the total number of rows. \fB\fCnum-rows\fR: Shows the total number of rows.
.IP \(bu 2 .IP \(bu 2
\fB\fCnum\-filtered\-rows\fR: Shows the total number of rows after filtering. \fB\fCnum-filtered-rows\fR: Shows the total number of rows after filtering.
.RE .RE
@ -1014,11 +1014,11 @@ The current widgets available in \fBrofi\fP:
\fB\fCelement\fR: a box in the listview holding the entries \fB\fCelement\fR: a box in the listview holding the entries
.RS .RS
.IP \(bu 2 .IP \(bu 2
\fB\fCelement\-icon\fR: the widget in the listview's entry showing the (optional) icon \fB\fCelement-icon\fR: the widget in the listview's entry showing the (optional) icon
.IP \(bu 2 .IP \(bu 2
\fB\fCelement\-index\fR: the widget in the listview's entry keybindable index (1,2,3..0) \fB\fCelement-index\fR: the widget in the listview's entry keybindable index (1,2,3..0)
.IP \(bu 2 .IP \(bu 2
\fB\fCelement\-text\fR: the widget in the listview's entry showing the text. \fB\fCelement-text\fR: the widget in the listview's entry showing the text.
.RE .RE
@ -1026,7 +1026,7 @@ The current widgets available in \fBrofi\fP:
.RE .RE
.IP \(bu 2 .IP \(bu 2
\fB\fCmode\-switcher\fR: the main horizontal @box packing the buttons. \fB\fCmode-switcher\fR: the main horizontal @box packing the buttons.
.RS .RS
.IP \(bu 2 .IP \(bu 2
\fB\fCbutton\fR: the buttons @textbox for each mode \fB\fCbutton\fR: the buttons @textbox for each mode
@ -1098,8 +1098,8 @@ Example:
.nf .nf
nametotextbox selected.active { nametotextbox selected.active {
background\-color: #003642; background-color: #003642;
text\-color: #008ed4; text-color: #008ed4;
} }
.fi .fi
@ -1132,16 +1132,16 @@ Margin on the outside of the widget
\fBborder\fP: border \fBborder\fP: border
Border around the widget (between padding and margin)/ Border around the widget (between padding and margin)/
.IP \(bu 2 .IP \(bu 2
\fBborder\-radius\fP: padding \fBborder-radius\fP: padding
Sets a radius on the corners of the borders. Sets a radius on the corners of the borders.
.IP \(bu 2 .IP \(bu 2
\fBbackground\-color\fP: color \fBbackground-color\fP: color
Background color Background color
.IP \(bu 2 .IP \(bu 2
\fBbackground\-image\fP: image \fBbackground-image\fP: image
Background image Background image
.IP \(bu 2 .IP \(bu 2
\fBborder\-color\fP: color \fBborder-color\fP: color
Color of the border Color of the border
.IP \(bu 2 .IP \(bu 2
\fBcursor\fP: cursor \fBcursor\fP: cursor
@ -1157,10 +1157,10 @@ The font used in the window
.IP \(bu 2 .IP \(bu 2
\fBtransparency\fP: string \fBtransparency\fP: string
Indicating if transparency should be used and what type: Indicating if transparency should be used and what type:
\fBreal\fP \- True transparency. Only works with a compositor. \fBreal\fP - True transparency. Only works with a compositor.
\fBbackground\fP \- Take a screenshot of the background image and use that. \fBbackground\fP - Take a screenshot of the background image and use that.
\fBscreenshot\fP \- Take a screenshot of the screen and use that. \fBscreenshot\fP - Take a screenshot of the screen and use that.
\fBPath\fP to png file \- Use an image. \fBPath\fP to png file - Use an image.
.IP \(bu 2 .IP \(bu 2
\fBlocation\fP: position \fBlocation\fP: position
The place of the anchor on the monitor The place of the anchor on the monitor
@ -1174,9 +1174,9 @@ Window is fullscreen.
\fBwidth\fP: distance \fBwidth\fP: distance
The width of the window The width of the window
.IP \(bu 2 .IP \(bu 2
\fBx\-offset\fP: distance \fBx-offset\fP: distance
.IP \(bu 2 .IP \(bu 2
\fBy\-offset\fP: distance \fBy-offset\fP: distance
The offset of the window to the anchor point, allowing you to push the window left/right/up/down The offset of the window to the anchor point, allowing you to push the window left/right/up/down
.RE .RE
@ -1184,13 +1184,13 @@ The offset of the window to the anchor point, allowing you to push the window le
.SS scrollbar: .SS scrollbar:
.RS .RS
.IP \(bu 2 .IP \(bu 2
\fBbackground\-color\fP: color \fBbackground-color\fP: color
.IP \(bu 2 .IP \(bu 2
\fBhandle\-width\fP: distance \fBhandle-width\fP: distance
.IP \(bu 2 .IP \(bu 2
\fBhandle\-color\fP: color \fBhandle-color\fP: color
.IP \(bu 2 .IP \(bu 2
\fBborder\-color\fP: color \fBborder-color\fP: color
.RE .RE
@ -1208,23 +1208,23 @@ The offset of the window to the anchor point, allowing you to push the window le
.SS textbox: .SS textbox:
.RS .RS
.IP \(bu 2 .IP \(bu 2
\fBbackground\-color\fP: color \fBbackground-color\fP: color
.IP \(bu 2 .IP \(bu 2
\fBborder\-color\fP: the color used for the border around the widget. \fBborder-color\fP: the color used for the border around the widget.
.IP \(bu 2 .IP \(bu 2
\fBfont\fP: the font used by this textbox (string). \fBfont\fP: the font used by this textbox (string).
.IP \(bu 2 .IP \(bu 2
\fBstr\fP: the string to display by this textbox (string). \fBstr\fP: the string to display by this textbox (string).
.IP \(bu 2 .IP \(bu 2
\fBvertical\-align\fP: Vertical alignment of the text. A number between 0 (top) and 1 (bottom). \fBvertical-align\fP: Vertical alignment of the text. A number between 0 (top) and 1 (bottom).
.IP \(bu 2 .IP \(bu 2
\fBhorizontal\-align\fP: Horizontal alignment of the text. A number between 0 (left) and 1 (right). \fBhorizontal-align\fP: Horizontal alignment of the text. A number between 0 (left) and 1 (right).
.IP \(bu 2 .IP \(bu 2
\fBtext\-color\fP: the text color to use. \fBtext-color\fP: the text color to use.
.IP \(bu 2 .IP \(bu 2
\fBhighlight\fP: text style {color}. \fBhighlight\fP: text style {color}.
color is optional, multiple highlight styles can be added like: bold underline italic #000000; color is optional, multiple highlight styles can be added like: bold underline italic #000000;
This option is only available on the \fB\fCelement\-text\fR widget. This option is only available on the \fB\fCelement-text\fR widget.
.IP \(bu 2 .IP \(bu 2
\fBwidth\fP: override the desired width for the textbox. \fBwidth\fP: override the desired width for the textbox.
.IP \(bu 2 .IP \(bu 2
@ -1232,13 +1232,13 @@ This option is only available on the \fB\fCelement\-text\fR widget.
.IP \(bu 2 .IP \(bu 2
\fBplaceholder\fP: Set the displayed text (String) when nothing is entered. \fBplaceholder\fP: Set the displayed text (String) when nothing is entered.
.IP \(bu 2 .IP \(bu 2
\fBplaceholder\-color\fP: Color of the placeholder text. \fBplaceholder-color\fP: Color of the placeholder text.
.IP \(bu 2 .IP \(bu 2
\fBblink\fP: Enable/Disable blinking on an input textbox (Boolean). \fBblink\fP: Enable/Disable blinking on an input textbox (Boolean).
.IP \(bu 2 .IP \(bu 2
\fBmarkup\fP: Force markup on, beware that only valid pango markup strings are shown. \fBmarkup\fP: Force markup on, beware that only valid pango markup strings are shown.
.IP \(bu 2 .IP \(bu 2
\fBtab\-stops\fP: array of distances \fBtab-stops\fP: array of distances
Set the location of tab stops by their distance from the beginning of the line. Set the location of tab stops by their distance from the beginning of the line.
Each distance should be greater than the previous one. Each distance should be greater than the previous one.
The text appears to the right of the tab stop position (other alignments are not supported yet). The text appears to the right of the tab stop position (other alignments are not supported yet).
@ -1251,7 +1251,7 @@ The text appears to the right of the tab stop position (other alignments are not
\fBcolumns\fP: integer \fBcolumns\fP: integer
Number of columns to show (at least 1) Number of columns to show (at least 1)
.IP \(bu 2 .IP \(bu 2
\fBfixed\-height\fP: boolean \fBfixed-height\fP: boolean
Always show \fB\fClines\fR rows, even if fewer elements are available. Always show \fB\fClines\fR rows, even if fewer elements are available.
.IP \(bu 2 .IP \(bu 2
\fBdynamic\fP: boolean \fBdynamic\fP: boolean
@ -1260,7 +1260,7 @@ Always show \fB\fClines\fR rows, even if fewer elements are available.
\fBscrollbar\fP: boolean \fBscrollbar\fP: boolean
If the scrollbar should be enabled/disabled. If the scrollbar should be enabled/disabled.
.IP \(bu 2 .IP \(bu 2
\fBscrollbar\-width\fP: distance \fBscrollbar-width\fP: distance
Width of the scrollbar Width of the scrollbar
.IP \(bu 2 .IP \(bu 2
\fBcycle\fP: boolean \fBcycle\fP: boolean
@ -1281,20 +1281,20 @@ Reverse the ordering (top down to bottom up).
\fBflow\fP: orientation \fBflow\fP: orientation
The order the elements are layed out. Vertical is the original 'column' view. The order the elements are layed out. Vertical is the original 'column' view.
.IP \(bu 2 .IP \(bu 2
\fBfixed\-columns\fP: boolean \fBfixed-columns\fP: boolean
Do not reduce the number of columns shown when number of visible elements is not enough to fill them all. Do not reduce the number of columns shown when number of visible elements is not enough to fill them all.
.RE .RE
.PP .PP
Each element is a \fB\fCbox\fR called \fB\fCelement\fR\&. Each \fB\fCelement\fR can contain an \fB\fCelement\-icon\fR and \fB\fCelement\-text\fR\&. Each element is a \fB\fCbox\fR called \fB\fCelement\fR\&. Each \fB\fCelement\fR can contain an \fB\fCelement-icon\fR and \fB\fCelement-text\fR\&.
.SS listview text highlight: .SS listview text highlight:
.PP .PP
The \fB\fCelement\-text\fR widget in the \fB\fClistview\fR is the one used to show the text. The \fB\fCelement-text\fR widget in the \fB\fClistview\fR is the one used to show the text.
On this widget set the \fB\fChighlight\fR property (only place this property is used) to change On this widget set the \fB\fChighlight\fR property (only place this property is used) to change
the style of highlighting. the style of highlighting.
The \fB\fChighlight\fR property consist of the \fB\fCtext\-style\fR property and a color. The \fB\fChighlight\fR property consist of the \fB\fCtext-style\fR property and a color.
.PP .PP
To disable highlighting: To disable highlighting:
@ -1303,7 +1303,7 @@ To disable highlighting:
.RS .RS
.nf .nf
element\-text { element-text {
highlight: None; highlight: None;
} }
@ -1317,7 +1317,7 @@ To set to red underlined:
.RS .RS
.nf .nf
element\-text { element-text {
highlight: underline red; highlight: underline red;
} }
@ -1343,42 +1343,42 @@ The current layout of \fBrofi\fP is structured as follows:
.RS .RS
.nf .nf
|\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| |------------------------------------------------------------------------------------|
| window {BOX:vertical} | | window {BOX:vertical} |
| |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| | | |-------------------------------------------------------------------------------| |
| | mainbox {BOX:vertical} | | | | mainbox {BOX:vertical} | |
| | |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| | | | | |---------------------------------------------------------------------------| | |
| | | inputbar {BOX:horizontal} | | | | | | inputbar {BOX:horizontal} | | |
| | | |\-\-\-\-\-\-\-\-\-| |\-| |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-|\-\-\-| |\-\-\-| |\-\-\-| |\-\-\-| | | | | | | |---------| |-| |---------------------------------|---| |---| |---| |---| | | |
| | | | prompt | |:| | entry |#fr| | / | |#ns| |ci | | | | | | | | prompt | |:| | entry |#fr| | / | |#ns| |ci | | | |
| | | |\-\-\-\-\-\-\-\-\-| |\_| |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-|\-\-\-| |\-\-\-| |\-\-\-| |\-\-\-| | | | | | | |---------| |_| |---------------------------------|---| |---| |---| |---| | | |
| | |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| | | | | |---------------------------------------------------------------------------| | |
| | | | | | | |
| | |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| | | | | |---------------------------------------------------------------------------| | |
| | | message | | | | | | message | | |
| | | |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| | | | | | | |-----------------------------------------------------------------------| | | |
| | | | textbox | | | | | | | | textbox | | | |
| | | |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| | | | | | | |-----------------------------------------------------------------------| | | |
| | |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| | | | | |---------------------------------------------------------------------------| | |
| | | | | | | |
| | |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| | | | |-----------------------------------------------------------------------------| |
| | | listview | | | | | listview | |
| | | |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-] | | | | | |------------------------------------------------------------------------] | |
| | | | element | | | | | | | element | | |
| | | | |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-] | | | | | | | |-----------------| |------------------------------------------------] | | |
| | | | |element\-icon | |element\-text | | | | | | | | |element-icon | |element-text | | | |
| | | | |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| | | | | | | | |-----------------| |------------------------------------------------| | | |
| | | |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-] | | | | | |------------------------------------------------------------------------] | |
| | |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| | | | |-----------------------------------------------------------------------------| |
| | | | | | | |
| | |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| | | | | |---------------------------------------------------------------------------| | |
| | | mode\-switcher {BOX:horizontal} | | | | | | mode-switcher {BOX:horizontal} | | |
| | | |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| |\-\-\-\-\-\-\-\-\-\-\-\-\-\-| |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| | | | | | | |---------------| |---------------| |--------------| |---------------| | | |
| | | | Button | | Button | | Button | | Button | | | | | | | | Button | | Button | | Button | | Button | | | |
| | | |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| |\-\-\-\-\-\-\-\-\-\-\-\-\-\-| |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| | | | | | | |---------------| |---------------| |--------------| |---------------| | | |
| | |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| | | | | |---------------------------------------------------------------------------| | |
| |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| | | |-------------------------------------------------------------------------------| |
|\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| |------------------------------------------------------------------------------------|
@ -1390,11 +1390,11 @@ The current layout of \fBrofi\fP is structured as follows:
.RS .RS
.IP \(bu 2 .IP \(bu 2
ci is the case\-indicator ci is the case-indicator
.IP \(bu 2 .IP \(bu 2
fr is the num\-filtered\-rows fr is the num-filtered-rows
.IP \(bu 2 .IP \(bu 2
ns is the num\-rows ns is the num-rows
.RE .RE
@ -1405,15 +1405,15 @@ ns is the num\-rows
.RS .RS
.nf .nf
|\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| |-----------------------------------------------------------------------------------|
| window {BOX:vertical} | | window {BOX:vertical} |
| |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| | | |------------------------------------------------------------------------------| |
| | error\-message {BOX:vertical} | | | | error-message {BOX:vertical} | |
| | |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| | | | | |-------------------------------------------------------------------------| | |
| | | textbox | | | | | | textbox | | |
| | |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| | | | | |-------------------------------------------------------------------------| | |
| |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| | | |------------------------------------------------------------------------------| |
|\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| |-----------------------------------------------------------------------------------|
@ -1435,17 +1435,17 @@ entry
.IP \(bu 2 .IP \(bu 2
overlay overlay
.IP \(bu 2 .IP \(bu 2
case\-indicator case-indicator
.IP \(bu 2 .IP \(bu 2
message message
.IP \(bu 2 .IP \(bu 2
listview listview
.IP \(bu 2 .IP \(bu 2
mode\-switcher mode-switcher
.IP \(bu 2 .IP \(bu 2
num\-rows num-rows
.IP \(bu 2 .IP \(bu 2
num\-filtered\-rows num-filtered-rows
.RE .RE
@ -1456,10 +1456,10 @@ These are used in the default theme as depicted in the figure above.
.RS .RS
.IP \(bu 2 .IP \(bu 2
mainbox mainbox
Packs: \fB\fCinputbar, message, listview, mode\-switcher\fR Packs: \fB\fCinputbar, message, listview, mode-switcher\fR
.IP \(bu 2 .IP \(bu 2
inputbar inputbar
Packs: \fB\fCprompt,entry,case\-indicator\fR Packs: \fB\fCprompt,entry,case-indicator\fR
.RE .RE
@ -1471,7 +1471,7 @@ There are several special widgets that can be used by prefixing the name of the
.SS textbox .SS textbox
.PP .PP
This is a read\-only textbox widget. The displayed string can be set with \fB\fCcontent\fR\&. This is a read-only textbox widget. The displayed string can be set with \fB\fCcontent\fR\&.
.PP .PP
Example: Example:
@ -1480,7 +1480,7 @@ Example:
.RS .RS
.nf .nf
textbox\-custom { textbox-custom {
expand: false; expand: false;
content: "My Message"; content: "My Message";
} }
@ -1492,7 +1492,7 @@ textbox\-custom {
.PP .PP
This is an icon widget. The displayed icon can be set with \fB\fCfilename\fR and size with \fB\fCsize\fR\&. This is an icon widget. The displayed icon can be set with \fB\fCfilename\fR and size with \fB\fCsize\fR\&.
If the property \fB\fCaction\fR is set, it acts as a button. If the property \fB\fCaction\fR is set, it acts as a button.
\fB\fCaction\fR can be set to a keybinding name and completes that action. (see rofi \-show keys for a list). \fB\fCaction\fR can be set to a keybinding name and completes that action. (see rofi -show keys for a list).
.PP .PP
If the \fB\fCsquared\fR property is set to \fBfalse\fP the widget height and width are not forced to be equal. If the \fB\fCsquared\fR property is set to \fBfalse\fP the widget height and width are not forced to be equal.
@ -1504,12 +1504,12 @@ Example:
.RS .RS
.nf .nf
icon\-paste { icon-paste {
expand: false; expand: false;
filename: "gtk\-paste"; filename: "gtk-paste";
size: 24; size: 24;
vertical\-align: 0.5; vertical-align: 0.5;
action: "kb\-primary\-paste"; action: "kb-primary-paste";
} }
.fi .fi
@ -1519,17 +1519,17 @@ icon\-paste {
.PP .PP
This is a textbox widget that can have a 'clickable' action. This is a textbox widget that can have a 'clickable' action.
The \fB\fCaction\fR can be set to: The \fB\fCaction\fR can be set to:
\fB\fCkeybinding\fR: accepts a keybinding name and completes that action. (see rofi \-show keys for a list). \fB\fCkeybinding\fR: accepts a keybinding name and completes that action. (see rofi -show keys for a list).
.PP .PP
.RS .RS
.nf .nf
button\-paste { button-paste {
expand: false; expand: false;
content: "My Clickable Message"; content: "My Clickable Message";
vertical\-align: 0.5; vertical-align: 0.5;
action: "kb\-primary\-paste"; action: "kb-primary-paste";
} }
.fi .fi
@ -1545,7 +1545,7 @@ property (this always happens on the \fB\fCbox\fR child, see example below):
.nf .nf
inputbar { inputbar {
children: [prompt,entry,overlay,case\-indicator]; children: [prompt,entry,overlay,case-indicator];
} }
.fi .fi
@ -1562,9 +1562,9 @@ Below is an example of a theme emulating dmenu:
.nf .nf
* { * {
background\-color: Black; background-color: Black;
text\-color: White; text-color: White;
border\-color: White; border-color: White;
font: "Times New Roman 12"; font: "Times New Roman 12";
} }
@ -1596,7 +1596,7 @@ element {
padding: 0px 2px; padding: 0px 2px;
} }
element selected { element selected {
background\-color: SteelBlue; background-color: SteelBlue;
} }
.fi .fi
@ -1610,18 +1610,18 @@ Just like CSS, \fBrofi\fP uses the box model for each widget.
.RS .RS
.nf .nf
|\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| |-------------------------------------------------------------------|
| margin | | margin |
| |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| | | |-------------------------------------------------------------| |
| | border | | | | border | |
| | |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| | | | | |---------------------------------------------------------| | |
| | | padding | | | | | | padding | | |
| | | |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| | | | | | | |-----------------------------------------------------| | | |
| | | | content | | | | | | | | content | | | |
| | | |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| | | | | | | |-----------------------------------------------------| | | |
| | |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| | | | | |---------------------------------------------------------| | |
| |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| | | |-------------------------------------------------------------| |
|\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| |-------------------------------------------------------------------|
.fi .fi
.RE .RE
@ -1631,15 +1631,15 @@ Explanation of the different parts:
.RS .RS
.IP \(bu 2 .IP \(bu 2
Content \- The content of the widget. Content - The content of the widget.
.IP \(bu 2 .IP \(bu 2
Padding \- Clears an area around the widget. Padding - Clears an area around the widget.
The padding shows the background color of the widget. The padding shows the background color of the widget.
.IP \(bu 2 .IP \(bu 2
Border \- A border that goes around the padding and content. Border - A border that goes around the padding and content.
The border use the border\-color of the widget. The border use the border-color of the widget.
.IP \(bu 2 .IP \(bu 2
Margin \- Clears an area outside the border. Margin - Clears an area outside the border.
The margin is transparent. The margin is transparent.
.RE .RE
@ -1660,15 +1660,15 @@ This property sets the distance between the packed widgets (both horizontally an
.RS .RS
.nf .nf
|\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| |---------------------------------------|
| |\-\-\-\-\-\-\-\-| s |\-\-\-\-\-\-\-\-| s |\-\-\-\-\-\-\-| | | |--------| s |--------| s |-------| |
| | child | p | child | p | child | | | | child | p | child | p | child | |
| | | a | | a | | | | | | a | | a | | |
| | | c | | c | | | | | | c | | c | | |
| | | i | | i | | | | | | i | | i | | |
| | | n | | n | | | | | | n | | n | | |
| |\-\-\-\-\-\-\-\-| g |\-\-\-\-\-\-\-\-| g |\-\-\-\-\-\-\-| | | |--------| g |--------| g |-------| |
|\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| |---------------------------------------|
.fi .fi
.RE .RE
@ -1681,15 +1681,15 @@ More dynamic spacing can be achieved by adding dummy widgets, for example to mak
.RS .RS
.nf .nf
|\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| |----------------------------------------------------|
| |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| |\-\-\-\-\-\-\-\-| |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| | | |---------------| |--------| |---------------| |
| | dummy | | child | | dummy | | | | dummy | | child | | dummy | |
| | expand: true; | | | | expand: true; | | | | expand: true; | | | | expand: true; | |
| | | | | | | | | | | | | | | |
| | | | | | | | | | | | | | | |
| | | | | | | | | | | | | | | |
| |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| |\-\-\-\-\-\-\-\-| |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| | | |---------------| |--------| |---------------| |
|\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| |----------------------------------------------------|
.fi .fi
.RE .RE
@ -1707,7 +1707,7 @@ To get debug information from the parser, run rofi like:
.RS .RS
.nf .nf
G\_MESSAGES\_DEBUG=Parser rofi \-show run G_MESSAGES_DEBUG=Parser rofi -show run
.fi .fi
.RE .RE
@ -1722,19 +1722,19 @@ To see the elements queried during running, run:
.RS .RS
.nf .nf
G\_MESSAGES\_DEBUG=Theme rofi \-show run G_MESSAGES_DEBUG=Theme rofi -show run
.fi .fi
.RE .RE
.PP .PP
To test minor changes, part of the theme can be passed on the command line, for example to set it to full\-screen: To test minor changes, part of the theme can be passed on the command line, for example to set it to full-screen:
.PP .PP
.RS .RS
.nf .nf
rofi \-theme\-str 'window { fullscreen:true;}' \-show run rofi -theme-str 'window { fullscreen:true;}' -show run
.fi .fi
.RE .RE
@ -1746,7 +1746,7 @@ Another syntax to modify theme properties is:
.RS .RS
.nf .nf
rofi \-theme+window+fullscreen true \-show run rofi -theme+window+fullscreen true -show run
.fi .fi
.RE .RE
@ -1758,7 +1758,7 @@ To print the current theme, run:
.RS .RS
.nf .nf
rofi \-dump\-theme rofi -dump-theme
.fi .fi
.RE .RE
@ -1771,7 +1771,7 @@ Parts of the theme can be conditionally loaded, like the CSS \fB\fC@media\fR opt
.RS .RS
.nf .nf
@media ( min\-width: 120 ) { @media ( min-width: 120 ) {
} }
@ -1783,19 +1783,19 @@ It supports the following keys as constraint:
.RS .RS
.IP \(bu 2 .IP \(bu 2
\fB\fCmin\-width\fR: load when width is bigger or equal then value. \fB\fCmin-width\fR: load when width is bigger or equal then value.
.IP \(bu 2 .IP \(bu 2
\fB\fCmax\-width\fR: load when width is smaller then value. \fB\fCmax-width\fR: load when width is smaller then value.
.IP \(bu 2 .IP \(bu 2
\fB\fCmin\-height\fR: load when height is bigger or equal then value. \fB\fCmin-height\fR: load when height is bigger or equal then value.
.IP \(bu 2 .IP \(bu 2
\fB\fCmax\-height\fR: load when height is smaller then value. \fB\fCmax-height\fR: load when height is smaller then value.
.IP \(bu 2 .IP \(bu 2
\fB\fCmin\-aspect\-ratio\fR load when aspect ratio is over value. \fB\fCmin-aspect-ratio\fR load when aspect ratio is over value.
.IP \(bu 2 .IP \(bu 2
\fB\fCmax\-aspect\-ratio\fR: load when aspect ratio is under value. \fB\fCmax-aspect-ratio\fR: load when aspect ratio is under value.
.IP \(bu 2 .IP \(bu 2
\fB\fCmonitor\-id\fR: The monitor id, see rofi \-help for id's. \fB\fCmonitor-id\fR: The monitor id, see rofi -help for id's.
.RE .RE
@ -1806,7 +1806,7 @@ It supports the following keys as constraint:
.RS .RS
.nf .nf
@media ( min\-width: 120 px ) { @media ( min-width: 120 px ) {
} }
@ -1875,11 +1875,11 @@ If a filename is provided, it will try to resolve it in the following order:
.RS .RS
.IP \(bu 2 .IP \(bu 2
\fB\fC${XDG\_CONFIG\_HOME}/rofi/themes/\fR \fB\fC${XDG_CONFIG_HOME}/rofi/themes/\fR
.IP \(bu 2 .IP \(bu 2
\fB\fC${XDG\_CONFIG\_HOME}/rofi/\fR \fB\fC${XDG_CONFIG_HOME}/rofi/\fR
.IP \(bu 2 .IP \(bu 2
\fB\fC${XDG\_DATA\_HOME}/rofi/themes/\fR \fB\fC${XDG_DATA_HOME}/rofi/themes/\fR
.IP \(bu 2 .IP \(bu 2
\fB\fC${INSTALL PREFIX}/share/rofi/themes/\fR \fB\fC${INSTALL PREFIX}/share/rofi/themes/\fR
@ -1895,4 +1895,4 @@ Several examples are installed together with \fBrofi\fP\&. These can be found in
.SH SEE ALSO .SH SEE ALSO
.PP .PP
rofi(1), rofi\-script(5), rofi\-theme\-selector(1) rofi(1), rofi-script(5), rofi-theme-selector(1)

396
doc/rofi.1
View file

File diff suppressed because it is too large Load diff