文档 自定义命令
在阅读本节之前,请查看 命令面板 文档,了解如何向命令面板添加自定义条目。
Sublime Merge 旨在可自定义。您可以轻松地将自己的自定义 Git 命令添加到菜单中,并使用自定义选择器创建更复杂的命令。
基本示例
以下是一个运行 git rebase -i master
的基本自定义 git
命令的示例。
{
"caption": "Interactive rebase onto master",
"command": "git",
"args": {"argv": ["rebase", "-i", "master"]}
}
您可以看到参数在 "argv"
数组中指定,每个参数之间用逗号分隔。
使用选择器
上面示例的局限性在于 master
是硬编码的。如果我们想选择一个分支来进行 rebase 呢?
这就是选择器派上用场的地方。选择器允许我们在运行时选择一个引用,而不是硬编码一个值。
可用选择器
Sublime Merge 支持以下选择器,这些选择器可与 git
命令一起使用
- $select_branch
- 允许用户选择一个分支(本地或远程)
- $select_local_branch
- 允许用户选择一个本地分支
- $select_remote_branch
- 允许用户选择一个远程分支
- $select_commit
- 允许用户选择一个提交(以提交哈希的形式)
- $select_tag
- 允许用户选择一个标签
- $select_stash
- 允许用户选择一个 stash(以 stash 索引的形式)
- $text
- 允许用户提供任意文本
如果我们想更新前面的示例,可以执行以下操作
{
"caption": "Interactive rebase…",
"command": "git",
"args": {"argv": ["rebase", "-i", "$select_branch"]}
}
现在,系统将提示用户选择一个分支来进行 rebase。