mirror of
https://github.com/ohmyzsh/ohmyzsh.git
synced 2026-01-30 02:44:42 +01:00
100 lines
2.7 KiB
Markdown
100 lines
2.7 KiB
Markdown
# eza plugin
|
|
|
|
This provides aliases that invoke the [`eza`](https://github.com/eza-community/eza) utility rather than `ls`
|
|
|
|
To use it add `eza` to the plugins array in your zshrc file:
|
|
|
|
```zsh
|
|
plugins=(... eza)
|
|
```
|
|
|
|
## Configuration
|
|
|
|
All configurations are done using the `zstyle` command in the `:omz:plugins:eza` namespace.
|
|
|
|
**NOTE:** The configuring needs to be done prior to OMZ loading the plugins. When the plugin is loaded, changing the `zstyle` won't have any effect.
|
|
|
|
### `dirs-first`
|
|
|
|
```zsh
|
|
zstyle ':omz:plugins:eza' 'dirs-first' $BOOL
|
|
```
|
|
|
|
If `true`, directories will be grouped first.
|
|
|
|
Default: `false`
|
|
|
|
|
|
### `git-status`
|
|
|
|
```zsh
|
|
zstyle ':omz:plugins:eza' 'git-status' $BOOL
|
|
```
|
|
|
|
If `true`, always add `--git` flag to indicate git status (if tracked / in a git repo).
|
|
|
|
Default: `false`
|
|
|
|
|
|
### `header`
|
|
|
|
```zsh
|
|
zstyle ':omz:plugins:eza' 'header' $BOOL
|
|
```
|
|
|
|
If `true`, always add `-h` flag to add a header row for each column.
|
|
|
|
Default: `false`
|
|
|
|
|
|
### `showgroup`
|
|
|
|
```zsh
|
|
zstyle ':omz:plugins:eza' 'showgroup' $BOOL
|
|
```
|
|
|
|
If `true` (default), always add `-g` flag to show the group ownership.
|
|
|
|
Default: `true`
|
|
|
|
|
|
### `size-prefix`
|
|
|
|
```zsh
|
|
zstyle ':omz:plugins:eza' 'size-prefix' ('binary'|'none'|'si')
|
|
```
|
|
|
|
Choose the prefix to be used in displaying file size:
|
|
|
|
* `binary` -- use [binary prefixes](https://en.wikipedia.org/wiki/Binary_prefix) such as "Ki", "Mi", "Gi" and so on
|
|
* `none` -- don't use any prefix, show size in bytes
|
|
* `si` (default) -- use [Metric/S.I. prefixes](https://en.wikipedia.org/wiki/Metric_prefix)
|
|
|
|
Default: `si`
|
|
|
|
|
|
### `time-style`
|
|
|
|
```zsh
|
|
zstyle ':omz:plugins:eza' 'time-style' $TIME_STYLE
|
|
```
|
|
|
|
Sets the `--time-style` option of `eza`. (See `man eza` for the options)
|
|
|
|
Default: Not set, which means the default behavior of `eza` will take place.
|
|
|
|
|
|
## Aliases
|
|
|
|
Note that aliases may be modified by Configuration.
|
|
|
|
|
|
| Alias | Command | Description |
|
|
| ------- | ----------------- | --------------------------------------------------------------------------- |
|
|
| `la` | `eza -la` | List all files (except . and ..) as a long list |
|
|
| `ldot` | `eza -ld .*` | List all dotfiles (directories shown as entries instead of recursed into) |
|
|
| `ll` | `eza -l` | List files as a long list |
|
|
| `ls` | `eza` | Plain eza call |
|
|
| `lS` | `eza -l -ssize` | List files as a long list, sorted by size |
|
|
| `lT` | `eza -l -snewest` | List files as a long list, sorted by date (newest last) |
|
|
|