1
0
Fork 0
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:
Dave Davenport 2022-07-16 13:33:13 +02:00
parent 52f587a191
commit 59e9b77a2e
5 changed files with 83 additions and 78 deletions

View file

@ -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.

View file

@ -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.

View file

@ -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.

View file

@ -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.

View file

@ -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