⚡️ 導入
クイックセットアップ
Place the following snippet to the .zshrc file:
- Instant
- Verified
source <(curl -sL init.zshell.dev); zzinit
This setup method requires manually verifying the sha256 checksum for a file lib/zsh/init.zsh every time the content is changed in the repository.
local cs_ok='7fab1ecb8d2ffbdb4aa98dd1e51cebaeaa4d8137e1de11938f3e0df24af262bb'
local cs_get=$(sha256sum <(curl -sL init.zshell.dev) | awk '{print $1}')
[[ $cs_ok == $cs_get ]] && { source <(curl -sL init.zshell.dev); zzinit; } || {
print -P "%F{160}▓▒░ Houston, we have a problem, the %F{226}$cs_get%F{160} do not match\!%f%b"; return 1
}
unset cs_ok cs_get
Reload the shell with exec zsh -il and run zi -h for usage information.
自動セットアップ
- Verify the sha256 checksum for file: lib/sh/install.sh
- If required append
-b <tag>or-b <branch>e.g:
sh -c "$(curl -fsSL get.zshell.dev)" -- -i skip -b main
- Minimal
- Loader
- Repository
- Annex
- ZUnit
Install and include minimal configuration to the .zshrc:
sh -c "$(curl -fsSL get.zshell.dev)" --
Install and include minimal configuration with loader:
sh -c "$(curl -fsSL get.zshell.dev)" -- -a loader
The installer will download the loader and add the snippet below to the .zshrc file.
if [[ -r "${XDG_CONFIG_HOME:-${HOME}/.config}/zi/init.zsh" ]]; then
source "${XDG_CONFIG_HOME:-${HOME}/.config}/zi/init.zsh" && zzinit
fi
The loader can be manually fetched from available links to any location on the system, and sourced from .zshrc or as shown in the quick-setup.
Then reload the shell with: exec zsh. すべて完了です！
デフォルトまたは カスタム の値を使用してリポジトリをクローンします:
sh -c "$(curl -fsSL get.zshell.dev)" -- -i skip
推奨する 別館 と最小構成の設定を使用してインストール:
sh -c "$(curl -fsSL get.zshell.dev)" -- -a annex
推奨する 別館 と最小構成の設定を使用し、また zdharma/zunit をインストール:
sh -c "$(curl -fsSL get.zshell.dev)" -- -a zunit
マニュアルセットアップ
インストール先を設定し、ディレクトリを作成します。
typeset -Ag ZI
typeset -gx ZI[HOME_DIR]="${HOME}/.zi" ZI[BIN_DIR]="${ZI[HOME_DIR]}/bin"
command mkdir -p "$ZI[BIN_DIR]"
For security reasons run function compaudit to check if the completion system would use files owned by root or by the current user, or files in directories that are world or group-writable.
失敗した場合は、現在のユーザーをディレクトリのオーナーに設定し、グループ/その他の書き込み権限を削除して、リポジトリを複製します。
compaudit | xargs chown -R "$(whoami)" "$ZI[HOME_DIR]"
compaudit | xargs chmod -R go-w "$ZI[HOME_DIR]"
command git clone https://github.com/z-shell/zi.git "$ZI[BIN_DIR]"
To enable Zi, source the zi.zsh from the previously set up directory placing the following snippet in the .zshrc file:
typeset -A ZI
ZI[BIN_DIR]="${HOME}/.zi/bin"
source "${ZI[BIN_DIR]}/zi.zsh"
以下の2行は、上の行の後、つまりZiを有効にした後に配置する必要があります。
以下でZi補完を有効にします:
autoload -Uz _zi
(( ${+_comps} )) && _comps[zi]=_zi
インストール後
After a fresh install, it is recommended to reload the shell and recompile Zi with:
- exec zsh -il
- zi self-update
Run zi -h for available commands or explore wiki to extend, customize and create 👍 🎉.
If you have any issue or need help 🤦♂️, lets discuss it or open an issue on GitHub.
It helps us to improve and make Zi better. Don't forget to help the project: share, contribute, or translate 🌐 🥰 🤓.
Let's glue a toolchain that works for us 🚀.
アイデアがありますか？
playgroundで提案・リクエストできます
sh -c "$(curl -fsSL get.zshell.dev)" -- -a ???
ウォーミングアップが必要ですか？
Docker Alpine
docker run --rm -it ghcr.io/z-shell/zd:latest
DockerでのTurbo Zi
If you create a Docker image that uses Zi, install Turbo-loaded plugins before the shell starts interactively, with the @zi-scheduler function in such a way, that it:
- Install plugins without waiting for the prompt (i.e. it's script friendly).
- Install all plugins instantly, without respecting the wait argument.
To accomplish this, use burst argument and call the @zi-scheduler function:
RUN zsh -i -c -- '@zi-scheduler burst || true'
- An example: Dockerfile
- In action: Playground
Zi Module: zpmod
The module transparently and automatically compiles sourced scripts and lists of all sourced files with the time the sourcing took in milliseconds on the left.