From 89c6a0f00b967e13e34dfee02cffc003b43d5ee9 Mon Sep 17 00:00:00 2001 From: Dave Davenport Date: Tue, 25 Jul 2017 08:13:07 +0200 Subject: [PATCH] Update rofi-theme manpage - Add orientation data type. - Add layout field to listview. --- doc/rofi-theme.5 | 129 ++++++++++++++++++++++---------------- doc/rofi-theme.5.markdown | 71 ++++++++++++--------- 2 files changed, 115 insertions(+), 85 deletions(-) diff --git a/doc/rofi-theme.5 b/doc/rofi-theme.5 index ded99d91..da618d68 100644 --- a/doc/rofi-theme.5 +++ b/doc/rofi-theme.5 @@ -260,6 +260,9 @@ a position\. a reference\. . .IP "\(bu" 4 +an orientation\. +. +.IP "\(bu" 4 a list of keywords\. . .IP "" 0 @@ -618,6 +621,16 @@ highlight: bold @pink; . .IP "" 0 . +.SH "Orientation" +. +.IP "\(bu" 4 +Format: \fB(horizontal|vertical)\fR +. +.IP "" 0 +. +.P +Specify an orientation of the widget\. +. .SH "List of keywords" . .IP "\(bu" 4 @@ -872,6 +885,9 @@ The following properties are currently supports: .SS "box:" . .IP "\(bu" 4 +\fBorientation\fR: orientation Set the direction the elements are packed\. +. +.IP "\(bu" 4 \fBspacing\fR: distance Distance between the packed elements\. . .IP "" 0 @@ -888,7 +904,7 @@ The following properties are currently supports: \fBtext\fR: The text color to use (falls back to foreground if not set) . .IP "\(bu" 4 -\fBhighlight\fR: highlight {color} Color is optional, multiple highlight styles can be added like: bold underlinei italic #000000; +\fBhighlight\fR: Text Style {color} Color is optional, multiple highlight styles can be added like: bold underline italic #000000; . .IP "" 0 . @@ -918,60 +934,8 @@ The following properties are currently supports: .IP "\(bu" 4 \fBlines\fR: integer Number of rows to show in the list view\. . -.IP "" 0 -. -.SH "DEBUGGING" -To get debug information from the parser run rofi like: -. -.IP "" 4 -. -.nf - -G_MESSAGES_DEBUG=Parser rofi \-show run -. -.fi -. -.IP "" 0 -. -.P -Syntax errors are shown in a popup and printed out to commandline with the above command\. -. -.P -To see the elements queried during running, run: -. -.IP "" 4 -. -.nf - -G_MESSAGES_DEBUG=Theme rofi \-show run -. -.fi -. -.IP "" 0 -. -.P -To test minor changes, part of the theme can be passed on the commandline, for example to set it fullscreen: -. -.IP "" 4 -. -.nf - -rofi \-theme\-str \'#window { fullscreen:true;}\' \-show run -. -.fi -. -.IP "" 0 -. -.P -To print the current theme run: -. -.IP "" 4 -. -.nf - -rofi \-dump\-theme -. -.fi +.IP "\(bu" 4 +\fBlayout\fR: orientation Indicate how elements are stacked\. Horizontal implements the dmenu style\. . .IP "" 0 . @@ -1216,6 +1180,61 @@ More dynamic spacing can be achieved by adding dummy widgets, for example to get .P If both dummy widgets are set to expanding, \fBchild\fR will be centered\. Depending on the \fBexpand\fR flag of child the remaining space will be equally divided between both dummy and child widget (expand enabled), or both dummy widgets (expand disabled)\. . +.SH "DEBUGGING" +To get debug information from the parser run rofi like: +. +.IP "" 4 +. +.nf + +G_MESSAGES_DEBUG=Parser rofi \-show run +. +.fi +. +.IP "" 0 +. +.P +Syntax errors are shown in a popup and printed out to commandline with the above command\. +. +.P +To see the elements queried during running, run: +. +.IP "" 4 +. +.nf + +G_MESSAGES_DEBUG=Theme rofi \-show run +. +.fi +. +.IP "" 0 +. +.P +To test minor changes, part of the theme can be passed on the commandline, for example to set it fullscreen: +. +.IP "" 4 +. +.nf + +rofi \-theme\-str \'#window { fullscreen:true;}\' \-show run +. +.fi +. +.IP "" 0 +. +.P +To print the current theme run: +. +.IP "" 4 +. +.nf + +rofi \-dump\-theme +. +.fi +. +.IP "" 0 +. .SH "EXAMPLES" Several examples are installed together with \fBrofi\fR\. These can be found in \fB{datadir}/rofi/themes/\fR where \fB{datadir}\fR is the install path of \fBrofi\fR data\. When installed using a package manager this is usually: \fB/usr/share/\fR\. . diff --git a/doc/rofi-theme.5.markdown b/doc/rofi-theme.5.markdown index 4c7f929d..48db4fa9 100644 --- a/doc/rofi-theme.5.markdown +++ b/doc/rofi-theme.5.markdown @@ -182,6 +182,7 @@ The current theme format support different type: * a border. * a position. * a reference. + * an orientation. * a list of keywords. Some of these types are a combination of other types. @@ -379,6 +380,12 @@ e.g. this is not valid: highlight: bold @pink; ``` +## Orientation + + * Format: `(horizontal|vertical)` + +Specify an orientation of the widget. + ## List of keywords * Format: `[ keyword, keyword ]` @@ -543,6 +550,8 @@ The following properties are currently supports: ### box: +* **orientation**: orientation + Set the direction the elements are packed. * **spacing**: distance Distance between the packed elements. @@ -551,8 +560,8 @@ The following properties are currently supports: * **background**: color * **foreground**: color * **text**: The text color to use (falls back to foreground if not set) -* **highlight**: highlight {color} - Color is optional, multiple highlight styles can be added like: bold underlinei italic #000000; +* **highlight**: Text Style {color} + Color is optional, multiple highlight styles can be added like: bold underline italic #000000; ### listview: * **columns**: integer @@ -571,34 +580,8 @@ The following properties are currently supports: Spacing between the elements (both vertical and horizontal) * **lines**: integer Number of rows to show in the list view. - -## DEBUGGING - -To get debug information from the parser run rofi like: - -``` -G_MESSAGES_DEBUG=Parser rofi -show run -``` - -Syntax errors are shown in a popup and printed out to commandline with the above command. - -To see the elements queried during running, run: - -``` -G_MESSAGES_DEBUG=Theme rofi -show run -``` - -To test minor changes, part of the theme can be passed on the commandline, for example to set it fullscreen: - -``` -rofi -theme-str '#window { fullscreen:true;}' -show run -``` - -To print the current theme run: - -``` -rofi -dump-theme -``` +* **layout**: orientation + Indicate how elements are stacked. Horizontal implements the dmenu style. ## Layout @@ -791,6 +774,34 @@ If both dummy widgets are set to expanding, `child` will be centered. Depending remaining space will be equally divided between both dummy and child widget (expand enabled), or both dummy widgets (expand disabled). +## DEBUGGING + +To get debug information from the parser run rofi like: + +``` +G_MESSAGES_DEBUG=Parser rofi -show run +``` + +Syntax errors are shown in a popup and printed out to commandline with the above command. + +To see the elements queried during running, run: + +``` +G_MESSAGES_DEBUG=Theme rofi -show run +``` + +To test minor changes, part of the theme can be passed on the commandline, for example to set it fullscreen: + +``` +rofi -theme-str '#window { fullscreen:true;}' -show run +``` + +To print the current theme run: + +``` +rofi -dump-theme +``` + ## EXAMPLES