qmk_firmware/docs/zh-cn/cli_tab_complete.md

33 lines
1.1 KiB
Markdown
Raw Permalink Normal View History

# QMK Tab补全
<!---
original document: 0.15.12:docs/cli_tab_complete.md
git diff 0.15.12 HEAD -- docs/cli_tab_complete.md | cat
-->
在使用Bash 4.2及更高版本、Zsh或FiSH时可以启用QMK CLI的Tab补全功能可以实现对 `qmk` 参数中的开关、键盘、文件等参数的自动补全。
## 设置
有以下几种启用Tab补全的方法。
### 仅当前用户生效
将以下内容添加到文件 `.profile``.bashrc` 的末尾:
source ~/qmk_firmware/util/qmk_tab_complete.sh
若你的 `qmk_firmware` 存放在其它路径,以上路径也需要调整。
### 系统级的符号关联
若想让所有本地用户都可以实现Tab补全可以按如下方法添加符号连接到 `qmk_tab_complete.sh` 脚本:
`ln -s ~/qmk_firmware/util/qmk_tab_complete.sh /etc/profile.d/qmk_tab_complete.sh`
### 系统级的脚本拷贝
有时符号连接的方案无效可以改用拷贝文件到指定位置的方案。但须留意该Tab补全脚本可能会不定时更新你需要定期重新拷贝一次该脚本。
cp util/qmk_tab_complete.sh /etc/profile.d