mirror of
https://github.com/davatorium/rofi.git
synced 2025-03-03 16:05:20 -05:00
Install rofi-theme-selector manpage.
This commit is contained in:
Dave Davenport
parent
ac91da123c
commit
74106921f4
8 changed files with 116 additions and 46 deletions
1
.gitignore
vendored
1
.gitignore
vendored
|
|
@ -32,7 +32,6 @@
|
|||
/textbox_test
|
||||
/rofi
|
||||
/doc/*.html
|
||||
/doc/*.1
|
||||
/doc/*.doxy
|
||||
/gitconfig.h
|
||||
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
||||
##
|
||||
|
|
|
|||
|
|
@ -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',
|
||||
)]
|
||||
)
|
||||
|
|
|
|||
49
doc/rofi-theme-selector.1
Normal file
49
doc/rofi-theme-selector.1
Normal file
|
|
@ -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
|
||||
|
||||
|
|
@ -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;
|
||||
}
|
||||
.
|
||||
|
|
|
|||
16
doc/rofi.1
16
doc/rofi.1
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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',
|
||||
)
|
||||
|
|
|
|||
Loading…
Add table
Reference in a new issue