[DOC] Small fixes to rofi-theme manpage.

This commit is contained in:
Dave Davenport 2022-04-07 21:02:55 +02:00
parent 2cc21909f5
commit bb1fd3afd7
2 changed files with 59 additions and 18 deletions

View file

@ -4,15 +4,38 @@
.PP
\fBrofi-theme\fP - Rofi theme format files
.SH GETTING STARTED
.SH GETTING STARTED WITH THEMING
.PP
The easiest way to get started theming rofi is by modifying your existing theme.
Themes can be modified/tweaked by adding theming elements to the end of your
config file. The default location of this file is \fB\fC~/.config/rofi/config.ras\fR,
.PP
Themes can be modified/tweaked by adding theming elements to the end of the
.br
config file. The default location of this file is \fB\fC~/.config/rofi/config.rasi\fR,
if the file does not exists, you can create it.
.PP
For example if we want to change the \fB\fCType to filter\fR text in the entry box:
A basic config:
.PP
.RS
.nf
configuration {
modes: [ combi ];
combi-modes: [ window, drun, run ];
}
@theme "gruvbox-light"
/* Insert theme modifications after this */
.fi
.RE
.PP
For example if we want to change the \fB\fCType to filter\fR text in the entry box we
append the following:
.PP
.RS
@ -26,7 +49,7 @@ entry {
.RE
.PP
In the above statement, \fB\fCentry\fR indicates the widget, \fB\fCplaceholder\fR is the
In the above section, \fB\fCentry\fR indicates the widget, \fB\fCplaceholder\fR is the
property we want to modify and we set it to the string \fB\fC"Type here"\fR\&.
To find the commonly available widgets in rofi, see the 'Basic structure' section.
@ -82,10 +105,11 @@ Resulting in the following packing:
.RE
.PP
The \fB\fCelement\fR (container) widget hold each entry in the \fB\fClistview\fR, we add the two
pre-defined children in the order we want to show them.
We also specify the packing direction (\fB\fCorientation\fR) and the spacing between the children (\fB\fCspacing\fR).
We specify the space between the two children in absolute pixels (\fB\fCpx\fR).
The \fB\fCelement\fR (container) widget hold each entry in the \fB\fClistview\fR, we add the
two pre-defined children in the order we want to show. We also specify the
packing direction (\fB\fCorientation\fR) and the spacing between the children
(\fB\fCspacing\fR). We specify the space between the two children in absolute pixels
(\fB\fCpx\fR).
.PP
To increase the icon-size, we need to modify the \fB\fCelement-icon\fR widget.

View file

@ -4,14 +4,30 @@
**rofi-theme** - Rofi theme format files
## GETTING STARTED
## GETTING STARTED WITH THEMING
The easiest way to get started theming rofi is by modifying your existing theme.
Themes can be modified/tweaked by adding theming elements to the end of your
config file. The default location of this file is `~/.config/rofi/config.ras`,
Themes can be modified/tweaked by adding theming elements to the end of the
config file. The default location of this file is `~/.config/rofi/config.rasi`,
if the file does not exists, you can create it.
For example if we want to change the `Type to filter` text in the entry box:
A basic config:
```css
configuration {
modes: [ combi ];
combi-modes: [ window, drun, run ];
}
@theme "gruvbox-light"
/* Insert theme modifications after this */
```
For example if we want to change the `Type to filter` text in the entry box we
append the following:
```css
entry {
@ -19,7 +35,7 @@ entry {
}
```
In the above statement, `entry` indicates the widget, `placeholder` is the
In the above section, `entry` indicates the widget, `placeholder` is the
property we want to modify and we set it to the string `"Type here"`.
To find the commonly available widgets in rofi, see the 'Basic structure' section.
@ -56,10 +72,11 @@ Resulting in the following packing:
└─────────────────────────────────────────────────────────────────────┘
```
The `element` (container) widget hold each entry in the `listview`, we add the two
pre-defined children in the order we want to show them.
We also specify the packing direction (`orientation`) and the spacing between the children (`spacing`).
We specify the space between the two children in absolute pixels (`px`).
The `element` (container) widget hold each entry in the `listview`, we add the
two pre-defined children in the order we want to show. We also specify the
packing direction (`orientation`) and the spacing between the children
(`spacing`). We specify the space between the two children in absolute pixels
(`px`).
To increase the icon-size, we need to modify the `element-icon` widget.