bottom 怎么安装 shell 自动补全文件?
【免费下载链接】bottomYet another cross-platform graphical process/system monitor.项目地址: https://gitcode.com/GitHub_Trending/bo/bottom
bottom(btm)是一款跨平台的图形化进程/系统监控终端工具。装好 bottom 之后,如果希望输入btm后按键能补全它的命令行参数,需要把 release 二进制包里自带的 shell 自动补全文件装到对应 shell 的补全目录。官方文档 Auto-Complete 给出的适用前提是:你使用的是包含自动补全文件的 release 二进制包,shell 为 Bash、Zsh、fish、PowerShell、Elvish、Fig 或 Nushell 之一。
从哪里获取补全文件
- release 页面(stable 与 nightly 均有)的 release 二进制包中打包了 Bash、Zsh、fish、Powershell、Elvish、Fig、Nushell 的自动补全文件,解压后就能看到这些文件。
- 如果只需要补全文件本身,stable/nightly release 中还单独提供了
completion.tar.gz,里面是各个 shell 对应的自动补全文件。
各 shell 对应的补全文件名如下(来自文档 Auto-Complete 与 README):
| Shell | 补全文件 |
|---|---|
| Bash | btm.bash |
| Zsh | _btm |
| fish | btm.fish |
| PowerShell | _btm.ps1 |
| Elvish | btm.elv |
| Fig | btm.ts |
| Nushell | btm.nu |
各 shell 的安装方式
按文档给出的方式,把对应文件放到相应位置即可:
- Bash:把
btm.bash移动到$XDG_CONFIG_HOME/bash_completion或/etc/bash_completion.d/(文档给出的是这两个位置,按需选其一)。 - Zsh:把
_btm移动到$fpath包含的任一目录下。 - fish:把
btm.fish移动到$HOME/.config/fish/completions/。 - PowerShell:把
_btm.ps1添加到你的 PowerShell profile。 - Elvish:使用
btm.elv作为补全文件。 - Fig:使用
btm.ts作为补全文件。 - Nushell:Auto-Complete 文档写的是 source
btm.nu(README 中对应条目写为 "usebtm.nu",两处表述略有差异,均为指向该文件)。
文档没有给出更细的操作命令(例如具体的cp示例),上表即为文档给出的完整安装路径:找到文件、放进文档指定的位置。
可选分支:通过 Alpine 包管理器安装
如果你使用的是 Alpine Linux,除了手动放置文件外,文档 README 还提供了一键安装的补全包,可与apk add bottom搭配使用:
# Bash 补全 apk add bottom-bash-completion # Fish 补全 apk add bottom-fish-completion # Zsh 补全 apk add bottom-zsh-completion限制说明
- 自动补全文件只随 release 二进制包(或
completion.tar.gz)提供,支持范围就是上面列出的七种 shell,文档未提供其他 shell 的补全方式。 - 如果你是通过源码构建(
cargo build --release --locked)而非使用 release 二进制,打包与分发文档 说明:设置BTM_GENERATE环境变量为非空值后构建(例如BTM_GENERATE=true cargo build --release --locked),构建脚本会把 completion 与 manpage 文件生成在target/tmp/bottom/下,可从该目录取用补全文件;该路径面向手动构建/打包场景。
【免费下载链接】bottomYet another cross-platform graphical process/system monitor.项目地址: https://gitcode.com/GitHub_Trending/bo/bottom
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考