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
|
.fi
|
||||||
.RE
|
.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
|
.SH Multiple file handling
|
||||||
.PP
|
.PP
|
||||||
The rasi file format offers two methods of including other files.
|
The rasi file format offers two methods of including other files.
|
||||||
|
|
|
@ -1342,6 +1342,34 @@ Or
|
||||||
FontAwesome 22
|
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
|
## Multiple file handling
|
||||||
|
|
||||||
The rasi file format offers two methods of including other files.
|
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.
|
If no match, the input is handled by the first combined modes.
|
||||||
|
|
||||||
.SH FAQ
|
.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.
|
.SS The text in the window switcher is not nicely aligned.
|
||||||
.PP
|
.PP
|
||||||
Try using a mono-space font.
|
Try using a mono-space font.
|
||||||
|
|
|
@ -857,34 +857,6 @@ If no match, the input is handled by the first combined modes.
|
||||||
|
|
||||||
## FAQ
|
## 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.
|
### The text in the window switcher is not nicely aligned.
|
||||||
|
|
||||||
Try using a mono-space font.
|
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
|
In dmenu mode (and script) you can now make (some) changes to the theme, for
|
||||||
example modifying the background color of the entry box.
|
example modifying the background color of the entry box.
|
||||||
|
|
||||||
You can now put users scripts (for script mode) into
|
User scripts (for script mode) into
|
||||||
`$XDG_CONFIG_HOME/rofi/scripts` directory and those are automatically available
|
`$XDG_CONFIG_HOME/rofi/scripts` directory are automatically available
|
||||||
in rofi.
|
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:
|
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.
|
* Change modi to modes to avoid confusion.
|
||||||
* [Theme] When links are unresolvable throw an error to the user.
|
* [Theme] When links are unresolvable throw an error to the user.
|
||||||
* [DMenu] Document the `display-columns` and `display-column-separator` option.
|
* [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
|
# Thanks
|
||||||
|
|
||||||
|
|
Loading…
Reference in a new issue