diff options
-rw-r--r-- | .gitignore | 1 | ||||
-rw-r--r-- | Makefile.am | 4 | ||||
-rw-r--r-- | doc/meson.build | 1 | ||||
-rw-r--r-- | doc/rofi-theme-selector.1 | 49 | ||||
-rw-r--r-- | doc/rofi-theme-selector.1.markdown (renamed from doc/rofi-theme-selector.1.md) | 0 | ||||
-rw-r--r-- | doc/rofi-theme.5 | 90 | ||||
-rw-r--r-- | doc/rofi.1 | 16 | ||||
-rw-r--r-- | meson.build | 1 |
8 files changed, 116 insertions, 46 deletions
@@ -32,7 +32,6 @@ /textbox_test /rofi /doc/*.html -/doc/*.1 /doc/*.doxy /gitconfig.h diff --git a/Makefile.am b/Makefile.am index df9c2294..efa65c4b 100644 --- a/Makefile.am +++ b/Makefile.am @@ -165,6 +165,7 @@ rofi_LDADD=\ ## dist_man1_MANS=\ doc/rofi.1\ + doc/rofi-theme-selector.1\ doc/rofi-sensible-terminal.1 dist_man5_MANS=\ @@ -237,8 +238,9 @@ EXTRA_DIST+=\ ## -update-manpage: $(top_srcdir)/doc/rofi.1.markdown $(top_srcdir)/doc/rofi-theme.5.markdown +update-manpage: $(top_srcdir)/doc/rofi-theme-selector.1.markdown $(top_srcdir)/doc/rofi.1.markdown $(top_srcdir)/doc/rofi-theme.5.markdown ronn --roff $(top_srcdir)/doc/rofi.1.markdown + ronn --roff $(top_srcdir)/doc/rofi-theme-selector.1.markdown ronn --roff $(top_srcdir)/doc/rofi-theme.5.markdown ## diff --git a/doc/meson.build b/doc/meson.build index f3c5443e..ef489afa 100644 --- a/doc/meson.build +++ b/doc/meson.build @@ -3,6 +3,7 @@ if ronn.found() run_target('update-manpage', command: [ ronn, '--roff', files( 'rofi.1.markdown', + 'rofi-theme-selector.1.markdown', 'rofi-theme.5.markdown', )] ) diff --git a/doc/rofi-theme-selector.1 b/doc/rofi-theme-selector.1 new file mode 100644 index 00000000..95499dd5 --- /dev/null +++ b/doc/rofi-theme-selector.1 @@ -0,0 +1,49 @@ +.\" generated with Ronn/v0.7.3 +.\" http://github.com/rtomayko/ronn/tree/0.7.3 +. +.TH "ROFI\-THEME\-SELECTOR" "1" "November 2017" "" "" +. +.SH "NAME" +\fBrofi\-theme\-selector\fR \- Preview and apply themes for \fBrofi\fR +. +.SH "DESCRIPTION" +\fBrofi\-theme\-selector\fR is a bash/rofi script to preview and apply themes for \fBrofi\fR\. It\'s part of any installation of \fBrofi\fR\. +. +.SH "USAGE" +. +.SS "Running rofi\-theme\-selector" +\fBrofi\-theme\-selector\fR shows a list of all available themes in a \fBrofi\fR window\. It lets you preview each theme with the Enter key and apply the theme to your \fBrofi\fR configuration file with Alt+a\. +. +.SH "Theme directories" +\fBrofi\-theme\-selector\fR searches the following directories for themes: +. +.IP "\(bu" 4 +${PREFIX}/share/rofi/themes +. +.IP "\(bu" 4 +$XDG_CONFIG_HOME/rofi +. +.IP "\(bu" 4 +$XDG_DATA_HOME/share/rofi/themes +. +.IP "" 0 +. +.P +${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_DATA_HOME is normally unset\. Default path is "$HOME/\.local/share"\. +. +.P +SEE ALSO rofi(1) +. +.P +AUTHOR Qball Cow qball@gmpclient\.org +. +.IP "" 4 +. +.nf + + Rasmus Steinke rasi@xssn\.at +. +.fi +. +.IP "" 0 + diff --git a/doc/rofi-theme-selector.1.md b/doc/rofi-theme-selector.1.markdown index 985a9597..985a9597 100644 --- a/doc/rofi-theme-selector.1.md +++ b/doc/rofi-theme-selector.1.markdown diff --git a/doc/rofi-theme.5 b/doc/rofi-theme.5 index 747f532d..98172ba4 100644 --- a/doc/rofi-theme.5 +++ b/doc/rofi-theme.5 @@ -1,7 +1,7 @@ .\" generated with Ronn/v0.7.3 .\" http://github.com/rtomayko/ronn/tree/0.7.3 . -.TH "ROFI\-THEME" "5" "October 2017" "" "" +.TH "ROFI\-THEME" "5" "November 2017" "" "" . .SH "NAME" \fBrofi\-theme\fR \- Rofi theme format files @@ -106,10 +106,10 @@ It is advised to define the \fIglobal properties section\fR on top of the file t } /* Element theme section\. */ -#{element path} { +{element path} { // list of properties } -#{elements\.\.\. } { +{elements\.\.\. } { // list of properties } . @@ -142,10 +142,10 @@ This is a valid element name: . .nf -#element normal\.normal { +element normal\.normal { background\-color: blue; } -#button { +button { background\-color: blue; } . @@ -160,7 +160,7 @@ And is identical to: . .nf -#element normal normal, button { +element normal normal, button { background\-color: blue; } . @@ -175,11 +175,11 @@ Each section inherits the global properties\. Properties can be explicitely inhe . .nf -#window { +window { a: 1; b: 2; } -#mainbox { +mainbox { a: inherit; b: 4; c: 8; @@ -190,7 +190,7 @@ Each section inherits the global properties\. Properties can be explicitely inhe .IP "" 0 . .P -The element \fB#mainbox\fR will have the following set of properties (if \fBmainbox\fR is a child of \fBwindow\fR): +The element \fBmainbox\fR will have the following set of properties (if \fBmainbox\fR is a child of \fBwindow\fR): . .IP "" 4 . @@ -649,6 +649,12 @@ south west | south | south east . .IP "" 0 . +.SH "Visibility" +It is possible to hide widgets: +. +.P +inputbar { enabled: false; } +. .SH "Reference" . .IP "\(bu" 4 @@ -680,7 +686,7 @@ But this is: myhigh: bold #FAA; } -#window { +window { highlight: @myhigh; } . @@ -722,7 +728,7 @@ Inherits the property from its parent widget\. . .nf -#mainbox { +mainbox { border\-color: inherit; } . @@ -740,7 +746,7 @@ For example: . .nf -#element selected { +element selected { } . .fi @@ -748,7 +754,7 @@ For example: .IP "" 0 . .P -Here \fB#element selected\fR is the name of the widget, \fBselected\fR is the state of the widget\. +Here \fBelement selected\fR is the name of the widget, \fBselected\fR is the state of the widget\. . .P The difference between dots and spaces is purely cosmetic\. These are all the same: @@ -757,11 +763,11 @@ The difference between dots and spaces is purely cosmetic\. These are all the sa . .nf -#element \.selected { +element \.selected { -#element\.selected { +element\.selected { } -#element selected { +element selected { } . .fi @@ -776,23 +782,23 @@ The current widgets available in \fBrofi\fR: .IP "\(bu" 4 . .IP "\(bu" 4 -\fB#overlay\fR: the overlay widget\. +\fBoverlay\fR: the overlay widget\. . .IP "\(bu" 4 . .IP "\(bu" 4 . .IP "\(bu" 4 -\fB#box\fR: the horizontal @box packing the widgets +\fBbox\fR: the horizontal @box packing the widgets . .IP "\(bu" 4 -\fB#case\-indicator\fR: the case/sort indicator @textbox +\fBcase\-indicator\fR: the case/sort indicator @textbox . .IP "\(bu" 4 -\fB#prompt\fR: the prompt @textbox +\fBprompt\fR: the prompt @textbox . .IP "\(bu" 4 -\fB#entry\fR: the main entry @textbox +\fBentry\fR: the main entry @textbox . .IP "" 0 @@ -800,10 +806,10 @@ The current widgets available in \fBrofi\fR: .IP "\(bu" 4 . .IP "\(bu" 4 -\fB#scrollbar\fR: the listview scrollbar +\fBscrollbar\fR: the listview scrollbar . .IP "\(bu" 4 -\fB#element\fR: the entries in the listview +\fBelement\fR: the entries in the listview . .IP "" 0 @@ -811,7 +817,7 @@ The current widgets available in \fBrofi\fR: .IP "\(bu" 4 . .IP "\(bu" 4 -\fB#button\fR: the buttons @textbox for each mode +\fBbutton\fR: the buttons @textbox for each mode . .IP "" 0 @@ -819,7 +825,7 @@ The current widgets available in \fBrofi\fR: .IP "\(bu" 4 . .IP "\(bu" 4 -\fB#textbox\fR: the message textbox +\fBtextbox\fR: the message textbox . .IP "" 0 @@ -845,10 +851,10 @@ Optional flag(s) indicating state of the widget, used for theming\. These are appended after the name or class of the widget\. . .SS "Example:" -\fB#button selected\.normal { }\fR +\fBbutton selected\.normal { }\fR . .P -\fB#element selected\.urgent { }\fR +\fBelement selected\.urgent { }\fR . .P Currently only the entrybox and scrollbar have states: @@ -872,7 +878,7 @@ Example: . .nf -#nametotextbox selected\.active { +nametotextbox selected\.active { background\-color: #003642; text\-color: #008ed4; } @@ -1045,29 +1051,29 @@ The current layout of \fBrofi\fR is structured as follows: .nf |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| -| #window {BOX:vertical} | +| window {BOX:vertical} | | |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| | -| | #mainbox {BOX:vertical} | | +| | mainbox {BOX:vertical} | | | | |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| | | -| | | #inputbar {BOX:horizontal} | | | +| | | inputbar {BOX:horizontal} | | | | | | |\-\-\-\-\-\-\-\-\-| |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| |\-\-\-| | | | -| | | | #prompt | | #entry | |#ci| | | | +| | | | prompt | | entry | |ci | | | | | | | |\-\-\-\-\-\-\-\-\-| |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| |\-\-\-| | | | | | |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| | | | | | | | | |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| | | -| | | #message | | | +| | | message | | | | | | |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| | | | -| | | | #textbox | | | | +| | | | textbox | | | | | | | |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| | | | | | |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| | | | | | | | | |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| | -| | | #listview | | +| | | listview | | | | |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| | | | | | | | |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| | | -| | | #sidebar {BOX:horizontal} | | | +| | | sidebar {BOX:horizontal} | | | | | | |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| |\-\-\-\-\-\-\-\-\-\-\-\-\-\-| |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| | | | | | | | Button | | Button | | Button | | Button | | | | | | | |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| |\-\-\-\-\-\-\-\-\-\-\-\-\-\-| |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| | | | @@ -1146,7 +1152,7 @@ Below is an example of a theme emulating dmenu: font: "Times New Roman 12"; } -#window { +window { anchor: north; location: north; width: 100%; @@ -1154,26 +1160,26 @@ Below is an example of a theme emulating dmenu: children: [ horibox ]; } -#horibox { +horibox { orientation: horizontal; children: [ prompt, entry, listview ]; } -#listview { +listview { layout: horizontal; spacing: 5px; lines: 10; } -#entry { +entry { expand: false; width: 10em; } -#element { +element { padding: 0px 2px; } -#element selected { +element selected { background\-color: SteelBlue; } . @@ -1,7 +1,7 @@ .\" generated with Ronn/v0.7.3 .\" http://github.com/rtomayko/ronn/tree/0.7.3 . -.TH "ROFI" "1" "October 2017" "" "" +.TH "ROFI" "1" "November 2017" "" "" . .SH "NAME" \fBrofi\fR \- A window switcher, application launcher, ssh dialog and dmenu replacement @@ -340,6 +340,18 @@ Disable plugin loading\. .P Specify the directory where \fBrofi\fR should look for plugins\. . +.P +\fB\-show\-icons\fR +. +.P +Show application icons in drun and window modes\. +. +.P +\fB\-drun\-icon\-theme\fR +. +.P +Specify icon theme to be used in drun mode if show\-icons setting is enabled\. If not specified default theme from DE is used, \fIAdwaita\fR and \fIgnome\fR themes act as fallback themes\. +. .SS "Matching" \fB\-matching\fR \fImethod\fR . @@ -1572,7 +1584,7 @@ Please see this \fIhttps://github\.com/DaveDavenport/rofi/wiki/Debugging%20Rofi\ When creating an issue, please read this \fIhttps://github\.com/DaveDavenport/rofi/blob/master/\.github/CONTRIBUTING\.md\fR first\. . .SH "SEE ALSO" -rofi\-sensible\-terminal(1), dmenu(1), rofi\-theme(5) +rofi\-sensible\-terminal(1), dmenu(1), rofi\-theme(5), rofi\-theme\-selector(1) . .SH "AUTHOR" Qball Cow \fIqball@gmpclient\.org\fR diff --git a/meson.build b/meson.build index 0786acd4..b98f5c2a 100644 --- a/meson.build +++ b/meson.build @@ -210,6 +210,7 @@ rofi = executable('rofi', rofi_sources + [ subdir('doc') install_man( 'doc/rofi.1', + 'doc/rofi-theme-selector.1', 'doc/rofi-sensible-terminal.1', 'doc/rofi-theme.5', ) |