Small tweaks to release note

This commit is contained in:
Dave Davenport 2017-09-25 22:28:47 +02:00
parent 5fdf5031d2
commit 1324bb0edd
1 changed files with 80 additions and 52 deletions

View File

@ -1,42 +1,52 @@
# V1.4.0: I reject your truth and trumpstitute my own
> This release contains some major changes. One of them being a new theme engine. The migration from older versions to
> this version might not go flawless.
> This release contains some major changes. One of them being a new theme
> engine. The migration from older versions to this version might not go
> flawless.
With more then 750 commits since the last version, this is one of the biggest releases so far.
In this version we used the groundwork laid in v1.3.0 and went completely nuts with it. Hopefully this release should
satisfy the die-hard desktop [ricers](https://www.reddit.com/r/unixporn/) with a brand new theme engine.
Lot of different colors, border, multiple fonts everything is now possible.
With more then 750 commits since the last version, this is one of the biggest
releases so far. In this version we used the groundwork laid in v1.3.0 and went
completely nuts with it. Hopefully this release should satisfy the die-hard
desktop [ricers](https://www.reddit.com/r/unixporn/) with a brand new theme
engine. Lot of different colors, border, multiple fonts everything is now
possible.
Because of The great work done by [SardemFF7](https://github.com/SardemFF7/) the code base is simplified and the
key and mouse handling improved. The libraries provided by SardemFF7 also made it possible to add a often requested
feature of icons (correctly using the icon-theme). A feature I never expected to be added. To top this off, SardemFF7
added support to build rofi using [meson](http://mesonbuild.com/).
Because of The great work done by [SardemFF7](https://github.com/SardemFF7/) the
code base is simplified and the key and mouse handling improved. The libraries
provided by SardemFF7 also made it possible to add a often requested feature of
icons (correctly using the icon-theme). A feature I never expected to be added.
To top this off, SardemFF7 added support to build rofi using
[meson](http://mesonbuild.com/).
A last big addition and still in beta, is support for plugins. Allowing the addition of some weird/fancy features.
Currently two plugins are available, [blezz](https://gitcrate.org/qtools/rofi-blezz) a quick launch menu with it own
menu definition and [top](https://gitcrate.org/qtools/rofi-top/) displaying running processes.
A last big addition and still in beta, is support for plugins. Allowing the
addition of some weird/fancy features. Currently two plugins are available,
[blezz](https://gitcrate.org/qtools/rofi-blezz) a quick launch menu with it own
menu definition and [top](https://gitcrate.org/qtools/rofi-top/) displaying
running processes.
Beside these major changes, this release includes a lot of bug-fixes and small improvements. See the bottom of this
release notes for a more complete list of changes.
Beside these major changes, this release includes a lot of bug-fixes and small
improvements. See the bottom of this release notes for a more complete list of
changes.
## Theme engine
The biggest new feature of this release is the theme engine. Building on the changes made in v1.3.0 we implemented a new
theme engine and it has a completely new theme format. While the themes are a lot more verbose now, it does allow for a
lot of extra customizations.
The biggest new feature of this release is the theme engine. Building on the
changes made in v1.3.0 we implemented a new theme engine and it has a completely
new theme format. While the themes are a lot more verbose now, it does allow for
a lot of extra customizations.
It is now possible to theme each widget in rofi independently:
### Colors
You can now set the color on each widget independent in most of the CSS supported color formats (hsl, cmyk, rgb, etc.)
and each color can have a transparency. There are three colors that can be set on each widget:
You can now set the color on each widget independent in most of the CSS
supported color formats (hsl, cmyk, rgb, etc.) and each color can have a
transparency. There are three colors that can be set on each widget:
* **background-color**
Used to draw the background of the widget. Each widget is drawn on top of it parent, if the background is
transparent, you will see the parents widget.
Used to draw the background of the widget. Each widget is drawn on top of it
parent, if the background is transparent, you will see the parents widget.
* **border-color**
Used to draw the borders.
* **text-color**
@ -46,51 +56,62 @@ and each color can have a transparency. There are three colors that can be set o
### Borders
On every widget we can now configure a border for each of the four sides, the color of the border, the style of the
border (solid or dashed) and the radius of the corners can be set.
On every widget we can now configure a border for each of the four sides, the
color of the border, the style of the border (solid or dashed) and the radius of
the corners can be set.
![border1](rofi-border.png)
This combined with (fake) transparency can make for a very nice looking, rounded rofi experience.
This combined with (fake) transparency can make for a very nice looking, rounded
rofi experience.
![border2](rofi-border-transp.png)
### Fonts
An often made request was support for different fonts for the entry box and the list. With the new theme, it is possible
to change the font and size of all widgets.
An often made request was support for different fonts for the entry box and the
list. With the new theme, it is possible to change the font and size of all
widgets.
![fonts](rofi-fonts.png)
> Note that opening a fonts is one of the slowest operations during rofi startup; having multiple fonts could have a
> significant impact on startup times.
> Note that opening a fonts is one of the slowest operations during rofi
> startup; having multiple fonts could have a significant impact on startup
> times.
### Flexible layout
To top all these changes, as an advanced feature the whole layout of the window can be changed. Making it possible to
mimic the original dmenu view, or make it appear as a minimal context menu.
To top all these changes, as an advanced feature the whole layout of the window
can be changed. Making it possible to mimic the original dmenu view, or make it
appear as a minimal context menu.
![dmenu](rofi-dmenu.png)
## Error reporting
The new theme parser will also be more verbose when encountering parsing errors, hopefully helping debugging and
modifying themes.
The new theme parser will also be more verbose when encountering parsing errors,
hopefully helping debugging and modifying themes.
For example when forgetting a trailing ';' will report where it failed, and what it expected (a ';').
For example when forgetting a trailing ';' will report where it failed, and what
it expected (a ';').
![rofi-error](rofi-error.png)
## Importing
The new theme parser also support importing and overriding. This allow you to make make modifications to an existing
theme, without having to completely copy it. For example, I want to use the `arthur` theme (shipped with rofi) but use
fake transparency and change the font off the result list.
The new theme parser also support importing and overriding. This allow you to
make make modifications to an existing theme, without having to completely copy
it. For example, I want to use the `arthur` theme (shipped with rofi) but use
fake transparency, change the font off the result list and import a set of
overriding colors from `mycolors`.
```css
// Import the default arthur theme
@import "arthur"
@theme "arthur"
// Load in overriding of colors from mycolors.
@import "mycolors"
/* on the window widget, set transparency to use a screenshot of the screen. */
#window {
@ -104,9 +125,11 @@ fake transparency and change the font off the result list.
## Icons
Another often made request, I never expected to be implemented, was icon support. With the help of SardemFF7 an
implementation was possible that correctly follows the XDG icon specification and does not negatively impact the
Another often made request, I never expected to be implemented, was icon
support. With the help of SardemFF7 an implementation was possible that
correctly follows the XDG icon specification and does not negatively impact the
performance. Currently the drun and the window switcher can application icons.
To enable icons, set the `show-icons` property to `true`.
![icons](rofi-icons.png)
@ -115,8 +138,8 @@ performance. Currently the drun and the window switcher can application icons.
## More flexible key and mouse bindings
Thanks to another great work of SardemFF7 you can now configure how the mouse
behave and bind modifier keys. It also improves on error messages. It will now
detect duplicate bindings.
behave and bind modifier keys. It also improves on error messages. For example
it will now detect duplicate bindings.
For example to select an entry on single click, instead of double click:
@ -127,8 +150,9 @@ rofi -show run -me-select-entry '' -me-accept-entry 'Mouse1'
## Fuzzy Matching
With thanks to Fangrui Song, the `fuzzy` matcher will now use a ranking similar to `fzf` to sort the results.
This should hopefully to improve the results, something a lot of users will appreciate.
With thanks to Fangrui Song, the `fuzzy` matcher will now use a ranking similar
to `fzf` to sort the results. This should hopefully to improve the results,
something a lot of users will appreciate.
Without:
@ -143,13 +167,15 @@ With:
> This feature is still in beta stage.
It is now possible to add custom mode via C plugins. This is allows interactive modi to be added to rofi.
For example it is possible to have `top` (display linux processes) mode:
It is now possible to add custom mode via C plugins. This is allows interactive
modi to be added to rofi. For example it is possible to have `top` (display
linux processes) mode:
![rofi top](rofi-top.png)
This mode allows sorting of the result on different keys (cpu usage, memory, etc.) to be selected, programs to be killed
and refreshes the results every 2 seconds.
This mode allows sorting of the result on different keys (cpu usage, memory,
etc.) to be selected, programs to be killed and refreshes the results every 2
seconds.
See [here](https://gitcrate.org/qtools/rofi-top).
@ -158,9 +184,10 @@ See [here](https://gitcrate.org/qtools/rofi-top).
> This feature is in alpha stage.
The new theme format can now (as an alpha) feature be used to set rofi's configuration. In the future, when we add
wayland support, we want to get rid of the current Xresources (X11) based configuration format.
You can see how this would look using: `rofi -dump-config`.
The new theme format can now (as an alpha) feature be used to set rofi's
configuration. In the future, when we add wayland support, we want to get rid of
the current Xresources (X11) based configuration format. You can see how this
would look using: `rofi -dump-config`.
## Detailed Changelog
@ -169,7 +196,8 @@ You can see how this would look using: `rofi -dump-config`.
* Keybinding. Duplicate bindings will now be reported.
* Invalid commandline options.
* Etc.
* Customizable highlight, allowing underline, strikethrough, italic, bold, small caps and the color to be set.
* Customizable highlight, allowing underline, strikethrough, italic, bold, small
caps and the color to be set.
* Give up when keyboard is not grabbed in first 5 seconds.
* Improve manpage
* rofi (1)