Migrating to Yazi v0.4.0 #1772
Description
Yazi v0.4 release note: https://github.com/sxyazi/yazi/releases/tag/v0.4.0
If you encounter any issues during the upgrade, please create a discussion and upload your logs.
TOC
- Migrating to Yazi v0.4.0 - here
- Lua API breaking changes
- Packaging
- Theme system breaking changes
1. Reserve the term select for future use
See #1773 for details.
1.1 - Renamed select command to toggle
# keymap.toml
[manager]
- { on = "<Space>", run = "select --state=none" },
+ { on = "<Space>", run = "toggle" },# keymap.toml
[manager]
- { on = "<C-r>", run = "select_all --state=none" },
+ { on = "<C-r>", run = "toggle_all" },
- { on = "<C-a>", run = "select_all --state=true" },
+ { on = "<C-a>", run = "toggle_all --state=on" },The documentation is now available for the two new commands: toggle command and toggle_all command.
1.2 - Renamed the select component to pick component
# yazi.toml / keymap.toml / theme.toml
- [select]
+ [pick]2. Correct the misuse of the term ctime and unify others
See #1761 for details.
2.1 - Renamed ctime to btime for the linemode command
# keymap.toml
[manager]
- { on = [ "m", "c" ], run = "linemode ctime" }
+ { on = [ "m", "b" ], run = "linemode btime" }2.2 - Renamed created to btime, modified to mtime for the sort_by option
# yazi.toml
[manager]
- sort_by = "created"
+ sort_by = "btime"
- sort_by = "modified"
+ sort_by = "mtime"2.3 - Renamed created to btime, modified to mtime for the sort command
# keymap.toml
[manager]
- { on = [ ",", "c" ], run = "sort created" }
+ { on = [ ",", "b" ], run = "sort btime" },
- { on = [ ",", "m" ], run = "sort modified" }
+ { on = [ ",", "m" ], run = "sort mtime" }3. Remove the x- prefix from mimetypes to unify behavior across different versions of file(1)
See #1927 for details.
# yazi.toml
[open]
- { mime = "application/x-{tar,bzip*,7z-compressed,xz,rar}", fg = "red" },
+ { mime = "application/{tar,bzip*,7z-compressed,xz,rar}", fg = "red" },# theme.toml
[filetype]
- { mime = "application/x-{tar,bzip*,7z-compressed,xz,rar}", fg = "red" },
+ { mime = "application/{tar,bzip*,7z-compressed,xz,rar}", fg = "red" },4. Deprecate the --sync option for the plugin command
See #1891 for details.
# keymap.toml
[manager]
- plugin --sync my-sync-plugin
+ plugin my-sync-plugin5. Remove the meaningless --confirm option to simplify the shell command
See #1982 for details.
# keymap.toml
[manager]
- shell "$SHELL" --block --confirm
+ shell "$SHELL" --block