mirror of
https://github.com/davatorium/rofi.git
synced 2024-11-25 13:55:34 -05:00
Remove -show-match option, deprecated.
Use 'element {highlight: none;}' in theme/configuration to reproduce it.
This commit is contained in:
Dave Davenport
parent
7824b1c84e
commit
d539e6478a
11 changed files with 295 additions and 54 deletions
|
|
@ -150,7 +150,6 @@ Settings config = {
|
|||
.fake_background = "screenshot",
|
||||
.window_format = "{w} {c} {t}",
|
||||
.click_to_exit = TRUE,
|
||||
.show_match = TRUE,
|
||||
.theme = NULL,
|
||||
.color_normal = NULL,
|
||||
.color_active = NULL,
|
||||
|
|
|
|||
|
|
@ -64,6 +64,8 @@ Rofi sets the following environment variable when executing the script:
|
|||
.SS \fB\fCROFI\_RETV\fR
|
||||
.PP
|
||||
An integer number with the current state:
|
||||
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
\fB0\fP: Initial call of script.
|
||||
.IP \(bu 2
|
||||
|
|
@ -73,6 +75,8 @@ An integer number with the current state:
|
|||
.IP \(bu 2
|
||||
\fB10\-28\fP: Custom keybinding 1\-19
|
||||
|
||||
.RE
|
||||
|
||||
.SS \fB\fCROFI\_INFO\fR
|
||||
.PP
|
||||
Environment get set when selected entry get set with the property value of the 'info' row option, if set.
|
||||
|
|
@ -96,6 +100,8 @@ For example to set the prompt:
|
|||
|
||||
.PP
|
||||
The following extra options exists:
|
||||
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
\fBprompt\fP: Update the prompt text.
|
||||
.IP \(bu 2
|
||||
|
|
@ -111,6 +117,8 @@ The following extra options exists:
|
|||
.IP \(bu 2
|
||||
\fBno\-custom\fP: If set to 'true'; only accept listed entries, ignore custom input.
|
||||
|
||||
.RE
|
||||
|
||||
.SH Parsing row options
|
||||
.PP
|
||||
Extra options for individual rows can be set.
|
||||
|
|
@ -130,6 +138,8 @@ For example:
|
|||
|
||||
.PP
|
||||
The following options are supported:
|
||||
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
\fBicon\fP: Set the icon for that row.
|
||||
.IP \(bu 2
|
||||
|
|
@ -139,6 +149,8 @@ The following options are supported:
|
|||
.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.
|
||||
|
||||
.RE
|
||||
|
||||
.PP
|
||||
multiple entries can be passed using the \fB\fC\\x1f\fR separator.
|
||||
|
||||
|
|
|
|||
|
|
@ -16,6 +16,8 @@ shipping this script in a way which is appropriate for the distribution.
|
|||
|
||||
.PP
|
||||
It tries to start one of the following (in that order):
|
||||
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
\fB\fC$TERMINAL\fR (this is a non\-standard variable)
|
||||
.IP \(bu 2
|
||||
|
|
@ -53,6 +55,8 @@ alacritty
|
|||
.IP \(bu 2
|
||||
kitty
|
||||
|
||||
.RE
|
||||
|
||||
.SH SEE ALSO
|
||||
.PP
|
||||
rofi(1)
|
||||
|
|
|
|||
|
|
@ -18,6 +18,8 @@ It lets you preview each theme with the Enter key and apply the theme to your
|
|||
.SH Theme directories
|
||||
.PP
|
||||
\fBrofi\-theme\-selector\fP searches the following directories for themes:
|
||||
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
${PREFIX}/share/rofi/themes
|
||||
.IP \(bu 2
|
||||
|
|
@ -25,6 +27,8 @@ $XDG\_CONFIG\_HOME/rofi/themes
|
|||
.IP \(bu 2
|
||||
$XDG\_DATA\_HOME/share/rofi/themes
|
||||
|
||||
.RE
|
||||
|
||||
.PP
|
||||
${PREFIX} reflects the install location of rofi. In most cases this will be "/usr".<br>
|
||||
$XDG\_CONFIG\_HOME is normally unset. Default path is "$HOME/.config".<br>
|
||||
|
|
|
|||
217
doc/rofi-theme.5
217
doc/rofi-theme.5
|
|
@ -19,11 +19,15 @@ preferred.
|
|||
.SH Comments
|
||||
.PP
|
||||
C and C++ file comments are supported.
|
||||
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
Anything after \fB\fC//\fR and before a newline is considered a comment.
|
||||
.IP \(bu 2
|
||||
Everything between \fB\fC/*\fR and \fB\fC*/\fR is a comment.
|
||||
|
||||
.RE
|
||||
|
||||
.PP
|
||||
Comments can be nested and the C comments can be inline.
|
||||
|
||||
|
|
@ -242,6 +246,8 @@ When used, values with the wrong type that cannot be converted are ignored.
|
|||
|
||||
.PP
|
||||
The current theme format supports different types:
|
||||
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
a string
|
||||
.IP \(bu 2
|
||||
|
|
@ -275,12 +281,18 @@ an environment variable
|
|||
.IP \(bu 2
|
||||
Inherit
|
||||
|
||||
.RE
|
||||
|
||||
.PP
|
||||
Some of these types are a combination of other types.
|
||||
|
||||
.SH String.IP \(bu 2
|
||||
.SH String
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
Format: \fB\fC"[:print:]+"\fR
|
||||
|
||||
.RE
|
||||
|
||||
.PP
|
||||
A string is always surrounded by double quotes (\fB\fC"\fR). Between the quotes there can be any printable character.
|
||||
|
||||
|
|
@ -299,9 +311,13 @@ font: "Awasome 12";
|
|||
.PP
|
||||
The string must be valid UTF\-8.
|
||||
|
||||
.SH Integer.IP \(bu 2
|
||||
.SH Integer
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
Format: \fB\fC[\-+]?[:digit:]+\fR
|
||||
|
||||
.RE
|
||||
|
||||
.PP
|
||||
An integer may contain any number.
|
||||
|
||||
|
|
@ -317,9 +333,13 @@ lines: 12;
|
|||
.fi
|
||||
.RE
|
||||
|
||||
.SH Real.IP \(bu 2
|
||||
.SH Real
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
Format: \fB\fC[\-+]?[:digit:]+(\\.[:digit:]+)?\fR
|
||||
|
||||
.RE
|
||||
|
||||
.PP
|
||||
A real is an integer with an optional fraction.
|
||||
|
||||
|
|
@ -338,9 +358,13 @@ real: 3.4;
|
|||
.PP
|
||||
The following is not valid: \fB\fC\&.3\fR, \fB\fC3.\fR or scientific notation: \fB\fC3.4e\-3\fR\&.
|
||||
|
||||
.SH Boolean.IP \(bu 2
|
||||
.SH Boolean
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
Format: \fB\fC(true|false)\fR
|
||||
|
||||
.RE
|
||||
|
||||
.PP
|
||||
Boolean value is either \fB\fCtrue\fR or \fB\fCfalse\fR\&. This is case\-\&sensitive.
|
||||
|
||||
|
|
@ -359,6 +383,8 @@ dynamic: false;
|
|||
.SH Color
|
||||
.PP
|
||||
\fBrofi\fP supports the color formats as specified in the CSS standard (1,2,3 and some of CSS 4)
|
||||
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
Format: \fB\fC#{HEX}{3}\fR (rgb)
|
||||
.IP \(bu 2
|
||||
|
|
@ -380,11 +406,15 @@ Format: \fB\fCcmyk( {PERCENTAGE}, {PERCENTAGE}, {PERCENTAGE}, {PERCENTAGE} [, {P
|
|||
.IP \(bu 2
|
||||
Format: \fB\fC{named\-color} [ / {PERCENTAGE} ]\fR
|
||||
|
||||
.RE
|
||||
|
||||
.PP
|
||||
The white\-space format proposed in CSS4 is also supported.
|
||||
|
||||
.PP
|
||||
The different values are:
|
||||
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
\fB\fC{HEX}\fR is a hexadecimal number ('0\-9a\-f' case insensitive).
|
||||
.IP \(bu 2
|
||||
|
|
@ -413,6 +443,8 @@ PapayaWhip, PeachPuff, Peru, Pink, Plum, PowderBlue, Purple, RebeccaPurple, Red,
|
|||
Salmon, SandyBrown, SeaGreen, SeaShell, Sienna, Silver, SkyBlue, SlateBlue, SlateGray, SlateGrey, Snow, SpringGreen,
|
||||
SteelBlue, Tan, Teal, Thistle, Tomato, Turquoise, Violet, Wheat, White, WhiteSmoke, Yellow, YellowGreen,transparent
|
||||
|
||||
.RE
|
||||
|
||||
.PP
|
||||
For example:
|
||||
|
||||
|
|
@ -440,12 +472,18 @@ text\-color: Black;
|
|||
.fi
|
||||
.RE
|
||||
|
||||
.SH Text style.IP \(bu 2
|
||||
.SH Text style
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
Format: \fB\fC(bold|italic|underline|strikethrough|none)\fR
|
||||
|
||||
.RE
|
||||
|
||||
.PP
|
||||
Text style indicates how the highlighted text is emphasized. \fB\fCNone\fR indicates that no emphasis
|
||||
should be applied.
|
||||
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
\fB\fCbold\fR: make the text thicker then the surrounding text.
|
||||
.IP \(bu 2
|
||||
|
|
@ -457,6 +495,8 @@ should be applied.
|
|||
.IP \(bu 2
|
||||
\fB\fCsmall caps\fR: emphasise the text using capitalization.
|
||||
|
||||
.RE
|
||||
|
||||
.PP
|
||||
.RS
|
||||
|
||||
|
|
@ -464,16 +504,22 @@ should be applied.
|
|||
For some reason \fB\fCsmall caps\fR does not work on some systems.
|
||||
.RE
|
||||
|
||||
.SH Line style.IP \(bu 2
|
||||
.SH Line style
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
Format: \fB\fC(dash|solid)\fR
|
||||
|
||||
.RE
|
||||
|
||||
.PP
|
||||
Indicates how a line should be drawn.
|
||||
It currently supports:
|
||||
* \fB\fCdash\fR: a dashed line, where the gap is the same width as the dash
|
||||
* \fB\fCsolid\fR: a solid line
|
||||
|
||||
.SH Distance.IP \(bu 2
|
||||
.SH Distance
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
Format: \fB\fC{Integer}px\fR
|
||||
.IP \(bu 2
|
||||
Format: \fB\fC{Real}em\fR
|
||||
|
|
@ -484,8 +530,12 @@ Format: \fB\fC{Real}%\fR
|
|||
.IP \(bu 2
|
||||
Format: \fB\fC{Integer}mm\fR
|
||||
|
||||
.RE
|
||||
|
||||
.PP
|
||||
A distance can be specified in 3 different units:
|
||||
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
\fB\fCpx\fR: Screen pixels.
|
||||
.IP \(bu 2
|
||||
|
|
@ -497,6 +547,8 @@ A distance can be specified in 3 different units:
|
|||
.IP \(bu 2
|
||||
\fB\fC%\fR: Percentage of the \fBmonitor\fP size.
|
||||
|
||||
.RE
|
||||
|
||||
.PP
|
||||
Distances used in the horizontal direction use the monitor width. Distances in
|
||||
the vertical direction use the monitor height.
|
||||
|
|
@ -530,6 +582,8 @@ width: calc( 100% \- 37px );
|
|||
|
||||
.PP
|
||||
It supports the following operations:
|
||||
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
\fB\fC+\fR : Add
|
||||
.IP \(bu 2
|
||||
|
|
@ -545,10 +599,14 @@ It supports the following operations:
|
|||
.IP \(bu 2
|
||||
\fB\fCmax\fR : Maximum of l or rvalue;
|
||||
|
||||
.RE
|
||||
|
||||
.PP
|
||||
It uses the C precedence ordering.
|
||||
|
||||
.SH Padding.IP \(bu 2
|
||||
.SH Padding
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
Format: \fB\fC{Integer}\fR
|
||||
.IP \(bu 2
|
||||
Format: \fB\fC{Distance}\fR
|
||||
|
|
@ -559,11 +617,15 @@ Format: \fB\fC{Distance} {Distance} {Distance}\fR
|
|||
.IP \(bu 2
|
||||
Format: \fB\fC{Distance} {Distance} {Distance} {Distance}\fR
|
||||
|
||||
.RE
|
||||
|
||||
.PP
|
||||
If no unit is specified, pixels are assumed.
|
||||
|
||||
.PP
|
||||
The different number of fields in the formats are parsed like:
|
||||
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
1 field: \fB\fCall\fR
|
||||
.IP \(bu 2
|
||||
|
|
@ -573,7 +635,11 @@ The different number of fields in the formats are parsed like:
|
|||
.IP \(bu 2
|
||||
4 fields: \fB\fCtop\fR, \fB\fCright\fR, \fB\fCbottom\fR, \fB\fCleft\fR
|
||||
|
||||
.SH Border.IP \(bu 2
|
||||
.RE
|
||||
|
||||
.SH Border
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
Format: \fB\fC{Integer}\fR
|
||||
.IP \(bu 2
|
||||
Format: \fB\fC{Distance}\fR
|
||||
|
|
@ -592,6 +658,8 @@ Format: \fB\fC{Distance} {Line style} {Distance} {Line style} {Distance} {Line s
|
|||
.IP \(bu 2
|
||||
Format: \fB\fC{Distance} {Line style} {Distance} {Line style} {Distance} {Line style} {Distance} {Line style}\fR
|
||||
|
||||
.RE
|
||||
|
||||
.PP
|
||||
Borders are identical to padding, except that each distance field has a line
|
||||
style property.
|
||||
|
|
@ -606,9 +674,12 @@ When no unit is specified, pixels are assumed.
|
|||
.SH Position
|
||||
.PP
|
||||
Indicate a place on the window/monitor.
|
||||
.IP \(bu 2
|
||||
Format: \fB\fC(center|east|north|west|south|north east|north west|south west|south east)\fR
|
||||
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
|
||||
.PP
|
||||
Format: \fB\fC(center|east|north|west|south|north east|north west|south west|south east)\fR
|
||||
.PP
|
||||
.RS
|
||||
|
||||
|
|
@ -623,6 +694,8 @@ south west | south | south east
|
|||
.fi
|
||||
.RE
|
||||
|
||||
.RE
|
||||
|
||||
.SH Visibility
|
||||
.PP
|
||||
It is possible to hide widgets:
|
||||
|
|
@ -632,9 +705,13 @@ inputbar {
|
|||
enabled: false;
|
||||
}
|
||||
|
||||
.SH Reference.IP \(bu 2
|
||||
.SH Reference
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
Format: \fB\fC@{PROPERTY NAME}\fR
|
||||
|
||||
.RE
|
||||
|
||||
.PP
|
||||
A reference can point to another reference. Currently, the maximum number of redirects is 20.
|
||||
A property always refers to another property. It cannot be used for a subpart of the property.
|
||||
|
|
@ -667,22 +744,34 @@ window {
|
|||
.fi
|
||||
.RE
|
||||
|
||||
.SH Orientation.IP \(bu 2
|
||||
.SH Orientation
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
Format: \fB\fC(horizontal|vertical)\fR
|
||||
|
||||
.RE
|
||||
|
||||
.PP
|
||||
Specify the orientation of the widget.
|
||||
|
||||
.SH List of keywords.IP \(bu 2
|
||||
.SH List of keywords
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
Format: \fB\fC[ keyword, keyword ]\fR
|
||||
|
||||
.RE
|
||||
|
||||
.PP
|
||||
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.
|
||||
|
||||
.SH Environment variable.IP \(bu 2
|
||||
.SH Environment variable
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
Format: \fB\fC${:alnum:}\fR
|
||||
|
||||
.RE
|
||||
|
||||
.PP
|
||||
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.
|
||||
|
|
@ -698,9 +787,13 @@ The environment variable should be an alphanumeric string without white\-space.
|
|||
.fi
|
||||
.RE
|
||||
|
||||
.SH Inherit.IP \(bu 2
|
||||
.SH Inherit
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
Format: \fB\fCinherit\fR
|
||||
|
||||
.RE
|
||||
|
||||
.PP
|
||||
Inherits the property from its parent widget.
|
||||
|
||||
|
|
@ -757,14 +850,20 @@ element selected {
|
|||
.SH Name
|
||||
.PP
|
||||
The current widgets available in \fBrofi\fP:
|
||||
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
\fB\fCwindow\fR
|
||||
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
\fB\fCoverlay\fR: the overlay widget.
|
||||
.IP \(bu 2
|
||||
\fB\fCmainbox\fR: The mainbox box.
|
||||
.IP \(bu 2
|
||||
\fB\fCinputbar\fR: The input bar box.
|
||||
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
\fB\fCbox\fR: the horizontal @box packing the widgets
|
||||
.IP \(bu 2
|
||||
|
|
@ -777,27 +876,49 @@ The current widgets available in \fBrofi\fP:
|
|||
\fB\fCnum\-rows\fR: Shows the total number of rows.
|
||||
.IP \(bu 2
|
||||
\fB\fCnum\-filtered\-rows\fR: Shows the total number of rows after filtering.
|
||||
|
||||
.RE
|
||||
.IP \(bu 2
|
||||
\fB\fClistview\fR: The listview.
|
||||
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
\fB\fCscrollbar\fR: the listview scrollbar
|
||||
.IP \(bu 2
|
||||
\fB\fCelement\fR: a box in the listview holding the entries
|
||||
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
\fB\fCelement\-icon\fR: the widget in the listview's entry showing the (optional) icon
|
||||
.IP \(bu 2
|
||||
\fB\fCelement\-index\fR: the widget in the listview's entry keybindable index (1,2,3..0)
|
||||
.IP \(bu 2
|
||||
\fB\fCelement\-text\fR: the widget in the listview's entry showing the text.
|
||||
|
||||
.RE
|
||||
|
||||
.RE
|
||||
.IP \(bu 2
|
||||
\fB\fCmode\-switcher\fR: the main horizontal @box packing the buttons.
|
||||
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
\fB\fCbutton\fR: the buttons @textbox for each mode
|
||||
|
||||
.RE
|
||||
.IP \(bu 2
|
||||
\fB\fCmessage\fR: The container holding the textbox.
|
||||
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
\fB\fCtextbox\fR: the message textbox
|
||||
|
||||
.RE
|
||||
|
||||
.RE
|
||||
|
||||
.RE
|
||||
|
||||
.PP
|
||||
Note that these path names match the default theme. Themes that provide a custom layout will have different
|
||||
elements, and structure.
|
||||
|
|
@ -869,7 +990,9 @@ This allows the colors used for drawing the handle to be set independently.
|
|||
.PP
|
||||
The following properties are currently supported:
|
||||
|
||||
.SS all widgets:.IP \(bu 2
|
||||
.SS all widgets:
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
\fBenabled\fP: enable/disable the widget
|
||||
.IP \(bu 2
|
||||
\fBpadding\fP: padding
|
||||
|
|
@ -890,7 +1013,11 @@ Background color
|
|||
\fBborder\-color\fP: color
|
||||
Color of the border
|
||||
|
||||
.SS window:.IP \(bu 2
|
||||
.RE
|
||||
|
||||
.SS window:
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
|
||||
.PP
|
||||
\fBfont\fP: string
|
||||
|
|
@ -934,7 +1061,11 @@ The width of the window
|
|||
\fBy\-offset\fP: distance
|
||||
The offset of the window to the anchor point, allowing you to push the window left/right/up/down
|
||||
|
||||
.SS scrollbar:.IP \(bu 2
|
||||
.RE
|
||||
|
||||
.SS scrollbar:
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
\fBbackground\-color\fP: color
|
||||
.IP \(bu 2
|
||||
\fBhandle\-width\fP: distance
|
||||
|
|
@ -943,14 +1074,22 @@ The offset of the window to the anchor point, allowing you to push the window le
|
|||
.IP \(bu 2
|
||||
\fBborder\-color\fP: color
|
||||
|
||||
.SS box:.IP \(bu 2
|
||||
.RE
|
||||
|
||||
.SS box:
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
\fBorientation\fP: orientation
|
||||
Set the direction the elements are packed.
|
||||
.IP \(bu 2
|
||||
\fBspacing\fP: distance
|
||||
Distance between the packed elements.
|
||||
|
||||
.SS textbox:.IP \(bu 2
|
||||
.RE
|
||||
|
||||
.SS textbox:
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
\fBbackground\-color\fP: color
|
||||
.IP \(bu 2
|
||||
\fBborder\-color\fP: the color used for the border around the widget.
|
||||
|
|
@ -980,7 +1119,11 @@ color is optional, multiple highlight styles can be added like: bold underline i
|
|||
.IP \(bu 2
|
||||
\fBmarkup\fP: Force markup on, beware that only valid pango markup strings are shown.
|
||||
|
||||
.SS listview:.IP \(bu 2
|
||||
.RE
|
||||
|
||||
.SS listview:
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
\fBcolumns\fP: integer
|
||||
Number of columns to show (at least 1)
|
||||
.IP \(bu 2
|
||||
|
|
@ -1014,6 +1157,8 @@ Reverse the ordering (top down to bottom up).
|
|||
\fBfixed\-columns\fP: boolean
|
||||
Do not reduce the number of columns shown when number of visible elements is not enough to fill them all.
|
||||
|
||||
.RE
|
||||
|
||||
.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\&.
|
||||
|
||||
|
|
@ -1140,6 +1285,8 @@ The layout of \fBrofi\fP can be tweaked by packing the 'fixed' widgets in a cust
|
|||
|
||||
.PP
|
||||
The following widgets are fixed, as they provide core \fBrofi\fP functionality:
|
||||
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
prompt
|
||||
.IP \(bu 2
|
||||
|
|
@ -1159,9 +1306,13 @@ num\-rows
|
|||
.IP \(bu 2
|
||||
num\-filtered\-rows
|
||||
|
||||
.RE
|
||||
|
||||
.PP
|
||||
The following keywords are defined and can be used to automatically pack a subset of the widgets.
|
||||
These are used in the default theme as depicted in the figure above.
|
||||
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
mainbox
|
||||
Packs: \fB\fCinputbar, message, listview, mode\-switcher\fR
|
||||
|
|
@ -1169,11 +1320,15 @@ Packs: \fB\fCinputbar, message, listview, mode\-switcher\fR
|
|||
inputbar
|
||||
Packs: \fB\fCprompt,entry,case\-indicator\fR
|
||||
|
||||
.RE
|
||||
|
||||
.PP
|
||||
Any widget name starting with \fB\fCtextbox\fR is a textbox widget, others are box widgets and can pack other widgets.
|
||||
|
||||
.PP
|
||||
There are several special widgets that can be used by prefixing the name of the widget:
|
||||
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
\fB\fCtextbox\fR:
|
||||
This is a textbox widget. The displayed string can be set with \fB\fCstr\fR\&.
|
||||
|
|
@ -1189,6 +1344,8 @@ The \fB\fCaction\fR can be set to:
|
|||
\fB\fCok|alternate\fR: accept entry and launch alternate action (for run launch in terminal).
|
||||
\fB\fCcustom|alternate\fR: accept custom input and launch alternate action.
|
||||
|
||||
.RE
|
||||
|
||||
.PP
|
||||
To specify children, set the \fB\fCchildren\fR
|
||||
property (this always happens on the \fB\fCbox\fR child, see example below):
|
||||
|
|
@ -1279,6 +1436,8 @@ Just like CSS, \fBrofi\fP uses the box model for each widget.
|
|||
|
||||
.PP
|
||||
Explanation of the different parts:
|
||||
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
Content \- The content of the widget.
|
||||
.IP \(bu 2
|
||||
|
|
@ -1291,6 +1450,8 @@ The border use the border\-color of the widget.
|
|||
Margin \- Clears an area outside the border.
|
||||
The margin is transparent.
|
||||
|
||||
.RE
|
||||
|
||||
.PP
|
||||
The box model allows us to add a border around elements, and to define space between elements.
|
||||
|
||||
|
|
@ -1415,6 +1576,8 @@ Parts of the theme can be conditionally loaded, like the CSS \fB\fC@media\fR opt
|
|||
|
||||
.PP
|
||||
It supports the following keys as constraint:
|
||||
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
\fB\fCmin\-width\fR: load when width is bigger or equal then value.
|
||||
.IP \(bu 2
|
||||
|
|
@ -1430,6 +1593,8 @@ It supports the following keys as constraint:
|
|||
.IP \(bu 2
|
||||
\fB\fCmonitor\-id\fR: The monitor id, see rofi \-help for id's.
|
||||
|
||||
.RE
|
||||
|
||||
.PP
|
||||
@media takes an integer number or a fraction, for integer number \fB\fCpx\fR can be added.
|
||||
|
||||
|
|
@ -1448,11 +1613,15 @@ It supports the following keys as constraint:
|
|||
.PP
|
||||
The rasi file format offers two methods of including other files.
|
||||
This can be used to modify existing themes, or have multiple variations on a theme.
|
||||
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
import: Import and parse a second file.
|
||||
.IP \(bu 2
|
||||
theme: Discard theme, and load file as a fresh theme.
|
||||
|
||||
.RE
|
||||
|
||||
.PP
|
||||
Syntax:
|
||||
|
||||
|
|
@ -1471,6 +1640,8 @@ The specified file can either by \fIname\fP, \fIfilename\fP,\fIfull path\fP\&.
|
|||
|
||||
.PP
|
||||
If a filename is provided, it will try to resolve it in the following order:
|
||||
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
\fB\fC${XDG\_CONFIG\_HOME}/rofi/themes/\fR
|
||||
.IP \(bu 2
|
||||
|
|
@ -1480,6 +1651,8 @@ If a filename is provided, it will try to resolve it in the following order:
|
|||
.IP \(bu 2
|
||||
\fB\fC${INSTALL PREFIX}/share/rofi/themes/\fR
|
||||
|
||||
.RE
|
||||
|
||||
.PP
|
||||
A name is resolved as a filename by appending the \fB\fC\&.rasi\fR extension.
|
||||
|
||||
|
|
|
|||
94
doc/rofi.1
94
doc/rofi.1
|
|
@ -68,6 +68,8 @@ Markup support can be enabled, see CONFIGURATION options.
|
|||
.SH CONFIGURATION
|
||||
.PP
|
||||
There are currently three methods of setting configuration options (evaluated in order below):
|
||||
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
System configuration file (for example \fB\fC/etc/rofi.rasi\fR or old format \fB\fC/etc/rofi.conf\fR).
|
||||
It first checks XDG\_CONFIG\_DIRS and then SYSCONFDIR (that is passed at compile time).
|
||||
|
|
@ -86,6 +88,8 @@ This is the recommended way of configuring \fBrofi\fP\&.
|
|||
.IP \(bu 2
|
||||
Command\-line options: Arguments passed to \fBrofi\fP\&.
|
||||
|
||||
.RE
|
||||
|
||||
.PP
|
||||
\fBTIP\fP: To get a template config file run: \fB\fCrofi \-dump\-xresources > rofi\-example.config\fR\&.
|
||||
|
||||
|
|
@ -137,6 +141,8 @@ rofi \-dump\-xresources
|
|||
|
||||
.PP
|
||||
The configuration system supports the following types:
|
||||
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
string
|
||||
.IP \(bu 2
|
||||
|
|
@ -146,6 +152,8 @@ char
|
|||
.IP \(bu 2
|
||||
Boolean
|
||||
|
||||
.RE
|
||||
|
||||
.PP
|
||||
Boolean options have a non\-default command\-line syntax. Example to enable option X:
|
||||
|
||||
|
|
@ -218,6 +226,8 @@ Try to parse the file and 0 when succesful.
|
|||
|
||||
.PP
|
||||
Specify the number of threads \fBrofi\fP should use:
|
||||
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
0: Autodetect the number of supported hardware threads.
|
||||
.IP \(bu 2
|
||||
|
|
@ -225,6 +235,8 @@ Specify the number of threads \fBrofi\fP should use:
|
|||
.IP \(bu 2
|
||||
2..N: Specify the maximum number of threads to use in the thread pool.
|
||||
|
||||
.RE
|
||||
|
||||
.PP
|
||||
\fB\fC\-display\fR \fIdisplay\fP
|
||||
|
||||
|
|
@ -363,21 +375,6 @@ Directory that is used to place temporary files, like history.
|
|||
.PP
|
||||
Select the scrolling method. 0: Per page, 1: continuous.
|
||||
|
||||
.PP
|
||||
\fB\fC\-[no\-]show\-match\fR
|
||||
|
||||
.PP
|
||||
Show the indicator that shows what part of the string is matched.
|
||||
|
||||
.PP
|
||||
.RS
|
||||
|
||||
.nf
|
||||
Default: *true*
|
||||
|
||||
.fi
|
||||
.RE
|
||||
|
||||
.PP
|
||||
\fB\fC\-normalize\-match\fR
|
||||
|
||||
|
|
@ -443,6 +440,8 @@ Make rofi steal focus on launch and restore close to window that held it when la
|
|||
.PP
|
||||
Specify the matching algorithm used.
|
||||
Current the following methods are supported.
|
||||
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
\fBnormal\fP: match the int string
|
||||
.IP \(bu 2
|
||||
|
|
@ -452,6 +451,8 @@ Current the following methods are supported.
|
|||
.IP \(bu 2
|
||||
\fBfuzzy\fP: do a fuzzy match
|
||||
|
||||
.RE
|
||||
|
||||
.PP
|
||||
Default: \fInormal\fP
|
||||
|
||||
|
|
@ -476,6 +477,8 @@ Only show desktop files that are present in the listed categories.
|
|||
.PP
|
||||
When using \fB\fCdrun\fR, match only with the specified Desktop entry fields.
|
||||
The different fields are:
|
||||
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
\fBname\fP: the application's name
|
||||
.IP \(bu 2
|
||||
|
|
@ -493,11 +496,15 @@ The different fields are:
|
|||
.PP
|
||||
Default: \fIname,generic,exec,categories,keywords\fP
|
||||
|
||||
.RE
|
||||
|
||||
.PP
|
||||
\fB\fC\-drun\-display\-format\fR
|
||||
|
||||
.PP
|
||||
The format string for the \fB\fCdrun\fR dialog:
|
||||
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
\fBname\fP: the application's name
|
||||
.IP \(bu 2
|
||||
|
|
@ -509,6 +516,8 @@ The format string for the \fB\fCdrun\fR dialog:
|
|||
.IP \(bu 2
|
||||
\fBcomment\fP: the application comment
|
||||
|
||||
.RE
|
||||
|
||||
.PP
|
||||
Pango markup can be used to formatting the output.
|
||||
|
||||
|
|
@ -545,6 +554,8 @@ Default: false
|
|||
.PP
|
||||
When using window mode, match only with the specified fields.
|
||||
The different fields are:
|
||||
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
\fBtitle\fP: window's title
|
||||
.IP \(bu 2
|
||||
|
|
@ -562,6 +573,8 @@ The different fields are:
|
|||
.PP
|
||||
Default: \fIall\fP
|
||||
|
||||
.RE
|
||||
|
||||
.PP
|
||||
\fB\fC\-matching\-negate\-char\fR \fIchar\fP
|
||||
|
||||
|
|
@ -722,6 +735,9 @@ rofi \-show run \-sidebar\-mode \-lines 0
|
|||
.fi
|
||||
.RE
|
||||
|
||||
.PP
|
||||
\fB\fC\-hover\-select\fR
|
||||
|
||||
.PP
|
||||
Automatically select the entry the mouse is hovering over. This option is best combined with custom mouse bindings.
|
||||
To utilize hover\-select and accept an entry in a single click, use:
|
||||
|
|
@ -730,7 +746,7 @@ To utilize hover\-select and accept an entry in a single click, use:
|
|||
.RS
|
||||
|
||||
.nf
|
||||
rofi \-show run \-hover\-select \-me\-select\-entry '' -me\-accept\-entry MousePrimary
|
||||
rofi \-show run \-hover\-select \-me\-select\-entry '' \-me\-accept\-entry MousePrimary
|
||||
|
||||
.fi
|
||||
.RE
|
||||
|
|
@ -764,6 +780,8 @@ When one entry is left, automatically select it.
|
|||
Select monitor to display \fBrofi\fP on.
|
||||
It accepts as input: \fIprimary\fP (if primary output is set), the \fIxrandr\fP output name, or integer number (in order of
|
||||
detection). Negative numbers are handled differently:
|
||||
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
\fB\-1\fP: the currently focused monitor.
|
||||
.IP \(bu 2
|
||||
|
|
@ -780,6 +798,8 @@ behavior.)
|
|||
.PP
|
||||
Default: \fI\-5\fP
|
||||
|
||||
.RE
|
||||
|
||||
.PP
|
||||
See \fB\fCrofi \-h\fR output for the detected monitors, their position, and size.
|
||||
|
||||
|
|
@ -815,11 +835,15 @@ This option can be specified multiple times.
|
|||
|
||||
.PP
|
||||
Override the default DPI setting.
|
||||
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
If set to \fB\fC0\fR, it tries to auto\-detect based on X11 screen size (similar to i3 and GTK).
|
||||
.IP \(bu 2
|
||||
If set to \fB\fC1\fR, it tries to auto\-detect based on the size of the monitor that \fBrofi\fP is displayed on (similar to latest Qt 5).
|
||||
|
||||
.RE
|
||||
|
||||
.PP
|
||||
\fB\fC\-selected\-row\fR \fIselected row\fP
|
||||
|
||||
|
|
@ -938,6 +962,8 @@ Format what is being displayed for windows.
|
|||
|
||||
.PP
|
||||
\fIfield\fP:
|
||||
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
\fBw\fP: desktop name
|
||||
.IP \(bu 2
|
||||
|
|
@ -949,6 +975,8 @@ Format what is being displayed for windows.
|
|||
.IP \(bu 2
|
||||
\fBc\fP: class
|
||||
|
||||
.RE
|
||||
|
||||
.PP
|
||||
\fIlen\fP: maximum field length (0 for auto\-size). If length and window \fIwidth\fP are negative, field length is \fIwidth \- len\fP\&.
|
||||
if length is positive, the entry will be truncated or padded to fill that length.
|
||||
|
|
@ -1015,11 +1043,15 @@ This setting can be changed at runtime (see \fB\fC\-kb\-toggle\-sort\fR).
|
|||
|
||||
.PP
|
||||
There are 2 sorting method:
|
||||
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
levenshtein (Default)
|
||||
.IP \(bu 2
|
||||
fzf sorting.
|
||||
|
||||
.RE
|
||||
|
||||
.PP
|
||||
\fB\fC\-max\-history\-size\fR \fInumber\fP
|
||||
|
||||
|
|
@ -1089,6 +1121,8 @@ Makes \fB\fCdmenu\fR searches case\-insensitive
|
|||
|
||||
.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:
|
||||
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
A single row: '5'
|
||||
.IP \(bu 2
|
||||
|
|
@ -1100,6 +1134,8 @@ A set of rows: '2,0,\-9'
|
|||
.IP \(bu 2
|
||||
Or any combination: '5,\-3:,7:11,2,0,\-9'
|
||||
|
||||
.RE
|
||||
|
||||
.PP
|
||||
\fB\fC\-u\fR \fIX\fP
|
||||
|
||||
|
|
@ -1126,6 +1162,8 @@ This mode returns directly when no entries given.
|
|||
|
||||
.PP
|
||||
Allows the output of dmenu to be customized (N is the total number of input entries):
|
||||
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
\&'s' selected string
|
||||
.IP \(bu 2
|
||||
|
|
@ -1141,6 +1179,8 @@ Allows the output of dmenu to be customized (N is the total number of input entr
|
|||
.IP \(bu 2
|
||||
\&'F' quoted filter string (user input)
|
||||
|
||||
.RE
|
||||
|
||||
.PP
|
||||
Default: 's'
|
||||
|
||||
|
|
@ -1330,6 +1370,8 @@ For more information on debugging, see the wiki
|
|||
.SH PATTERN
|
||||
.PP
|
||||
To launch commands (for example, when using the ssh launcher), the user can enter the used command\-line. The following keys can be used that will be replaced at runtime:
|
||||
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
\fB\fC{host}\fR: the host to connect to
|
||||
.IP \(bu 2
|
||||
|
|
@ -1341,6 +1383,8 @@ To launch commands (for example, when using the ssh launcher), the user can ente
|
|||
.IP \(bu 2
|
||||
\fB\fC{window}\fR: the window ID of the selected window (in \fB\fCwindow\-command\fR)
|
||||
|
||||
.RE
|
||||
|
||||
.SH DMENU REPLACEMENT
|
||||
.PP
|
||||
If \fB\fCargv[0]\fR (calling command) is dmenu, \fBrofi\fP will start in dmenu mode.
|
||||
|
|
@ -1363,6 +1407,8 @@ manual.
|
|||
.PP
|
||||
The theme setup allows you to specify colors per state, similar to \fBi3\fP
|
||||
Currently 3 states exist:
|
||||
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
\fBnormal\fP: normal row
|
||||
.IP \(bu 2
|
||||
|
|
@ -1370,8 +1416,12 @@ Currently 3 states exist:
|
|||
.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
|
||||
|
|
@ -1383,6 +1433,8 @@ For each state, the following 5 colors must be set:
|
|||
.IP \(bu 2
|
||||
\fBhlbg\fP: background color selected row
|
||||
|
||||
.RE
|
||||
|
||||
.PP
|
||||
The window background and border color should be specified separately. The key \fB\fCcolor\-window\fR contains
|
||||
a tuple \fB\fCbackground,border,separator\fR\&.
|
||||
|
|
@ -1468,6 +1520,8 @@ of the window will be visible through it.
|
|||
.SH KEY BINDINGS
|
||||
.PP
|
||||
\fBrofi\fP has the following key bindings:
|
||||
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
\fB\fCCtrl\-v, Insert\fR: Paste from clipboard
|
||||
.IP \(bu 2
|
||||
|
|
@ -1533,6 +1587,8 @@ of the window will be visible through it.
|
|||
.IP \(bu 2
|
||||
\fB\fCAlt\-Shift\-S\fR: Take a screenshot and store it in the Pictures directory.
|
||||
|
||||
.RE
|
||||
|
||||
.PP
|
||||
To get a full list of key bindings on the commandline, see \fB\fCrofi \-h\fR\&.
|
||||
The options starting with \fB\fC\-kb\fR are keybindings.
|
||||
|
|
@ -1808,7 +1864,9 @@ first.
|
|||
.PP
|
||||
\fBrofi\-sensible\-terminal(1)\fP, \fBdmenu(1)\fP, \fBrofi\-theme(5)\fP, \fBrofi\-script(5)\fP, \fBrofi\-theme\-selector(1)\fP
|
||||
|
||||
.SH AUTHOR.IP \(bu 2
|
||||
.SH AUTHOR
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
Qball Cow
|
||||
\[la]qball@gmpclient.org\[ra]
|
||||
.IP \(bu 2
|
||||
|
|
@ -1818,6 +1876,8 @@ Rasmus Steinke
|
|||
Quentin Glidic
|
||||
\[la]sardemff7+rofi@sardemff7.net\[ra]
|
||||
|
||||
.RE
|
||||
|
||||
.PP
|
||||
Original code based on work by: Sean Pringle
|
||||
\[la]sean.pringle@gmail.com\[ra]
|
||||
|
|
|
|||
|
|
@ -212,12 +212,6 @@ Directory that is used to place temporary files, like history.
|
|||
|
||||
Select the scrolling method. 0: Per page, 1: continuous.
|
||||
|
||||
`-[no-]show-match`
|
||||
|
||||
Show the indicator that shows what part of the string is matched.
|
||||
|
||||
Default: *true*
|
||||
|
||||
`-normalize-match`
|
||||
|
||||
Normalize the string before matching, so o will match ö, and é matches e.
|
||||
|
|
|
|||
|
|
@ -106,8 +106,6 @@ rofi.scroll-method: 0
|
|||
! rofi.window-format: {w} {c} {t}
|
||||
! "Click outside the window to exit" Set from: Default
|
||||
! rofi.click-to-exit: true
|
||||
! "Indicate how it match by underlining it." Set from: Default
|
||||
! rofi.show-match: true
|
||||
! "New style theme file" Set from: Default
|
||||
! rofi.theme:
|
||||
! "Color scheme for normal row" Set from: Default
|
||||
|
|
|
|||
|
|
@ -181,7 +181,6 @@ typedef struct
|
|||
char *window_format;
|
||||
/** Click outside the window to exit */
|
||||
int click_to_exit;
|
||||
gboolean show_match;
|
||||
|
||||
char *theme;
|
||||
/** Path where plugins can be found. */
|
||||
|
|
|
|||
|
|
@ -1025,7 +1025,7 @@ static void update_callback ( textbox *t, icon *ico, unsigned int index, void *u
|
|||
icon_set_surface ( ico, icon );
|
||||
}
|
||||
|
||||
if ( state->tokens && config.show_match ) {
|
||||
if ( state->tokens ) {
|
||||
RofiHighlightColorStyle th = { ROFI_HL_BOLD | ROFI_HL_UNDERLINE, { 0.0, 0.0, 0.0, 0.0 } };
|
||||
th = rofi_theme_get_highlight ( WIDGET ( t ), "highlight", th );
|
||||
helper_token_match_get_pango_attr ( th, state->tokens, textbox_get_visible_text ( t ), list );
|
||||
|
|
|
|||
|
|
@ -207,8 +207,6 @@ static XrmOption xrmOptions[] = {
|
|||
"Window Format. w (desktop name), t (title), n (name), r (role), c (class)", CONFIG_DEFAULT },
|
||||
{ xrm_Boolean, "click-to-exit", { .snum = &config.click_to_exit }, NULL,
|
||||
"Click outside the window to exit", CONFIG_DEFAULT },
|
||||
{ xrm_Boolean, "show-match", { .snum = &config.show_match }, NULL,
|
||||
"Indicate how it match by underlining it.", CONFIG_DEFAULT },
|
||||
{ xrm_String, "theme", { .str = &config.theme }, NULL,
|
||||
"New style theme file", CONFIG_DEFAULT },
|
||||
{ xrm_String, "color-normal", { .str = &config.color_normal }, NULL,
|
||||
|
|
@ -234,7 +232,7 @@ static XrmOption xrmOptions[] = {
|
|||
{ xrm_Boolean, "drun-reload-desktop-cache", { .snum = &config.drun_reload_desktop_cache }, NULL,
|
||||
"DRUN: If enabled, reload the cache with desktop file content.", CONFIG_DEFAULT },
|
||||
{ xrm_Boolean, "normalize-match", { .snum = &config.normalize_match }, NULL,
|
||||
"Normalize string when matching (implies -no-show-match).", CONFIG_DEFAULT },
|
||||
"Normalize string when matching (disables match highlighting).", CONFIG_DEFAULT },
|
||||
{ xrm_Boolean, "steal-focus", { .snum = &config.steal_focus }, NULL,
|
||||
"Steal focus on launch and restore to window that had it on rofi start on close .", CONFIG_DEFAULT },
|
||||
};
|
||||
|
|
|
|||
Loading…
Reference in a new issue