mirror of
https://github.com/davatorium/rofi.git
synced 2024-11-25 13:55:34 -05:00
[Doc] Update releasenotes, move section in manpage.
This commit is contained in:
parent
52f587a191
commit
59e9b77a2e
5 changed files with 83 additions and 78 deletions
|
@ -2099,6 +2099,54 @@ FontAwesome 22
|
|||
.fi
|
||||
.RE
|
||||
|
||||
.SH Icon Handling
|
||||
.PP
|
||||
Rofi supports 3 ways of specifying an icon:
|
||||
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
Filename
|
||||
.IP \(bu 2
|
||||
icon-name, this is looked up via the icon-theme.
|
||||
.IP \(bu 2
|
||||
Markup String. It renders a string as an icon.
|
||||
|
||||
.RE
|
||||
|
||||
.PP
|
||||
For the first two options, GdkPixbuf is used to open and render the icons.
|
||||
This in general gives support for most required image formats.
|
||||
For the string option it uses Pango to render the string. The string needs to
|
||||
start with a \fB\fC<span\fR tag, that allows you to set color and font.
|
||||
|
||||
.PP
|
||||
Markup string:
|
||||
|
||||
.PP
|
||||
.RS
|
||||
|
||||
.nf
|
||||
echo -en "testing\\0icon\\x1f<span color='red'>⏻</span>" | ./rofi -dmenu
|
||||
|
||||
.fi
|
||||
.RE
|
||||
|
||||
.PP
|
||||
Getting supported icon formats:
|
||||
|
||||
.PP
|
||||
.RS
|
||||
|
||||
.nf
|
||||
G_MESSAGES_DEBUG=Helpers.IconFetcher rofi
|
||||
|
||||
.fi
|
||||
.RE
|
||||
|
||||
.PP
|
||||
This uses the debug framework and prints out a list of supported image file
|
||||
extensions.
|
||||
|
||||
.SH Multiple file handling
|
||||
.PP
|
||||
The rasi file format offers two methods of including other files.
|
||||
|
|
|
@ -1342,6 +1342,34 @@ Or
|
|||
FontAwesome 22
|
||||
```
|
||||
|
||||
## Icon Handling
|
||||
|
||||
Rofi supports 3 ways of specifying an icon:
|
||||
|
||||
* Filename
|
||||
* icon-name, this is looked up via the icon-theme.
|
||||
* Markup String. It renders a string as an icon.
|
||||
|
||||
|
||||
For the first two options, GdkPixbuf is used to open and render the icons.
|
||||
This in general gives support for most required image formats.
|
||||
For the string option it uses Pango to render the string. The string needs to
|
||||
start with a `<span` tag, that allows you to set color and font.
|
||||
|
||||
Markup string:
|
||||
|
||||
```bash
|
||||
echo -en "testing\0icon\x1f<span color='red'>⏻</span>" | ./rofi -dmenu
|
||||
```
|
||||
|
||||
Getting supported icon formats:
|
||||
|
||||
```bash
|
||||
G_MESSAGES_DEBUG=Helpers.IconFetcher rofi
|
||||
```
|
||||
This uses the debug framework and prints out a list of supported image file
|
||||
extensions.
|
||||
|
||||
## Multiple file handling
|
||||
|
||||
The rasi file format offers two methods of including other files.
|
||||
|
|
48
doc/rofi.1
48
doc/rofi.1
|
@ -1328,54 +1328,6 @@ modes are shown, even if the rest of the input text would match results from \fB
|
|||
If no match, the input is handled by the first combined modes.
|
||||
|
||||
.SH FAQ
|
||||
.SS What icon formats are supported
|
||||
.PP
|
||||
Rofi supports 3 ways of specifying an icon:
|
||||
|
||||
.RS
|
||||
.IP \(bu 2
|
||||
Filename
|
||||
.IP \(bu 2
|
||||
icon-name, this is looked up via the icon-theme.
|
||||
.IP \(bu 2
|
||||
Markup String. It renders a string as an icon.
|
||||
|
||||
.RE
|
||||
|
||||
.PP
|
||||
For the first two options, GdkPixbuf is used to open and render the icons.
|
||||
This in general gives support for most required image formats.
|
||||
For the string option it uses Pango to render the string. The string needs to
|
||||
start with a \fB\fC<span\fR tag, that allows you to set color and font.
|
||||
|
||||
.PP
|
||||
Markup string:
|
||||
|
||||
.PP
|
||||
.RS
|
||||
|
||||
.nf
|
||||
echo -en "testing\\0icon\\x1f<span color='red'>⏻</span>" | ./rofi -dmenu
|
||||
|
||||
.fi
|
||||
.RE
|
||||
|
||||
.PP
|
||||
Getting supported icon formats:
|
||||
|
||||
.PP
|
||||
.RS
|
||||
|
||||
.nf
|
||||
G_MESSAGES_DEBUG=Helpers.IconFetcher rofi
|
||||
|
||||
.fi
|
||||
.RE
|
||||
|
||||
.PP
|
||||
This uses the debug framework and prints out a list of supported image file
|
||||
extensions.
|
||||
|
||||
.SS The text in the window switcher is not nicely aligned.
|
||||
.PP
|
||||
Try using a mono-space font.
|
||||
|
|
|
@ -857,34 +857,6 @@ If no match, the input is handled by the first combined modes.
|
|||
|
||||
## FAQ
|
||||
|
||||
### What icon formats are supported
|
||||
|
||||
Rofi supports 3 ways of specifying an icon:
|
||||
|
||||
* Filename
|
||||
* icon-name, this is looked up via the icon-theme.
|
||||
* Markup String. It renders a string as an icon.
|
||||
|
||||
|
||||
For the first two options, GdkPixbuf is used to open and render the icons.
|
||||
This in general gives support for most required image formats.
|
||||
For the string option it uses Pango to render the string. The string needs to
|
||||
start with a `<span` tag, that allows you to set color and font.
|
||||
|
||||
Markup string:
|
||||
|
||||
```bash
|
||||
echo -en "testing\0icon\x1f<span color='red'>⏻</span>" | ./rofi -dmenu
|
||||
```
|
||||
|
||||
Getting supported icon formats:
|
||||
|
||||
```bash
|
||||
G_MESSAGES_DEBUG=Helpers.IconFetcher rofi
|
||||
```
|
||||
This uses the debug framework and prints out a list of supported image file
|
||||
extensions.
|
||||
|
||||
### The text in the window switcher is not nicely aligned.
|
||||
|
||||
Try using a mono-space font.
|
||||
|
|
|
@ -27,10 +27,13 @@ current selected item.
|
|||
In dmenu mode (and script) you can now make (some) changes to the theme, for
|
||||
example modifying the background color of the entry box.
|
||||
|
||||
You can now put users scripts (for script mode) into
|
||||
`$XDG_CONFIG_HOME/rofi/scripts` directory and those are automatically available
|
||||
User scripts (for script mode) into
|
||||
`$XDG_CONFIG_HOME/rofi/scripts` directory are automatically available
|
||||
in rofi.
|
||||
|
||||
You can now render text as icons, this allows you to use glyphs icon fonts as
|
||||
icons.
|
||||
|
||||
|
||||
Below is a more complete list of changes:
|
||||
|
||||
|
@ -67,6 +70,8 @@ Below is a more complete list of changes:
|
|||
* Change modi to modes to avoid confusion.
|
||||
* [Theme] When links are unresolvable throw an error to the user.
|
||||
* [DMenu] Document the `display-columns` and `display-column-separator` option.
|
||||
* [Theme] Media now supports `enabled` that supports an environment variable.
|
||||
* [IconFetcher] Support rendering fonts as icon.
|
||||
|
||||
# Thanks
|
||||
|
||||
|
|
Loading…
Reference in a new issue