配置 - 显示相关
messages
- 描述 : 自定义命令行提问信息
- 例子 :
json
{
"messages": {
"type": "Select the type of change that you're committing:",
"scope": "Denote the SCOPE of this change (optional):"
// ...
}
}
{
"messages": {
"type": "Select the type of change that you're committing:",
"scope": "Denote the SCOPE of this change (optional):"
// ...
}
}
themeColorCode
- 描述 : 设置终端交互部件的主题色
- 类型 :
string
- 默认 :
""
(⇒ cyan 青色)
TIP
使用 256 Color
- 规则:
"38;5;${color_code: 0 ~ 255}"
⇒color_code
可以通过链接查看获取 https://github.com/sindresorhus/xterm-colors - 示例:
"38;5;075"
- 规则:
使用 256 RGB Color (不推荐使用在团队项目中使用,需要终端支持,兼容性较差)
- 规则:
"38;2;${R};${G};${B}"
⇒ 你可以查看这个链接,查看你使用的终端是否支持显示 256 RGB True-Color: https://github.com/termstandard/colors - 示例:
"38;2;255;100;0"
- 规则:
如果你不想要采用配置记录的主题色,可以在~/.bashrc
或者 ~/.zshrc
等 profile 文件中添加一行,其优先级会更高:
sh
export ___X_CMD_THEME_COLOR_CODE="38;5;043"
export ___X_CMD_THEME_COLOR_CODE="38;5;043"
types
- 描述 : 自定义选择类型提示
- 类型 :
Array<{ name: string; value: string; emoji?: string }>
- 例子 :
types: [{value: 'feat', name: 'feat: 新增功能 | A new feature', emoji: ':sparkles:'}]
TIP
如果要使用 Emoji 需要 开启 userEmoji
配置项。
并且需添加 Emoji Code,可以在: https://gitmoji.dev/ 或 emoji-cheat-sheet 查找相应的字符进行补充到 emoji
。
useEmoji
- 描述 : 是否开启 commit message 带有 Emoji 字符。
- 类型 :
boolean
- 默认 :
false
TIP
尝试运行命令 可在当前会话直接开启输出 emoji 模式
- 使用 Commitizen CLI:
emoji=1 cz
- 使用 cz-git CLI:
czg emoji
emojiAlign
- 描述 : 设置 Emoji 字符 的 位于头部位置
- 类型 :
"left" | "center" | "right"
- 默认 :
"center"
- 示例 :
<left> type(scope): <center> subject <right>
typesAppend
- 描述 : 在默认 types 的基础上,添加额外的 types
- 类型 :
Array<{ name: string; value: string; emoji?: string }>
- 使用 : 只想额外添加少量types,不想添加臃肿的默认配置,或改变默认配置的显示顺序时使用。
- 默认 :
[]
- 例子 :
json
{
"typesAppend": [
{ "value": "workflow", "name": "workflow: Workflow changes" },
{ "value": "*!", "name": "*!: BREAKING CHANGES" }
]
}
{
"typesAppend": [
{ "value": "workflow", "name": "workflow: Workflow changes" },
{ "value": "*!", "name": "*!: BREAKING CHANGES" }
]
}
typesSearchValue
- 描述 : 默认
types
类别列表的模糊搜索针对列表value
字段。设置为false
后针对列表name
字段 - 类型 :
boolean
- 默认 :
true
scopesSearchValue
- 描述 : 默认
scopes
范围列表的模糊搜索针对列表name
字段。设置为true
后针对列表value
字段 - 类型 :
boolean
- 默认 :
false
customScopesAlign
- 描述 : 设置 选择范围 中 为空选项(empty) 和 自定义选项(custom) 的 位置
- 类型 :
"top" | "bottom" | "top-bottom" | "bottom-top"
- 默认 :
"bottom"
customScopesAlias
- 描述 : 自定义 选择范围 中 自定义选项(custom) 在命令行中显示的 名称
- 类型 :
string
- 默认 :
custom
emptyScopesAlias
- 描述 : 自定义 选择范围 中 为空选项(empty) 在命令行中显示的 名称
- 类型 :
string
- 默认 :
empty
customIssuePrefixAlign
- 描述 : 设置 选择 issue 前缀 中 跳过选项(skip) 和 自定义选项(custom) 的 位置
- 类型 :
"top" | "bottom" | "top-bottom" | "bottom-top"
- 默认 :
"top"
customIssuePrefixAlias
- 描述 : 自定义 选择 issue 前缀 中 自定义选项(custom) 在命令行中显示的 名称
- 类型 :
string
- 默认 :
custom
emptyIssuePrefixAlias
- 描述 : 自定义 选择 issue 前缀 中 跳过选项(skip) 在命令行中显示的 名称
- 类型 :
string
- 默认 :
skip
confirmColorize
- 描述 : 确定提交中模板 commit message 是否着色
- 类型 :
boolean
- 默认 :
true
TIP
使用 默认值 可以产生很多种玩法让工具更契合你或团队的习惯,可查看小窍门
defaultType
- 描述 : 如果 defaultType 与
types
选择范围列表项中的 value 相匹配就会进行星标置顶操作。 - 类型 :
string
- 默认 :
""
defaultScope
- 描述 : 如果 defaultScope 与
scopes
选择范围列表项中的 value 相匹配就会进行星标置顶操作。 - 类型 :
string
|string[]
[...] 在多选模式中会默认选中 - 默认 :
""
- 额外 : 在 自定义范围 中是否使用显示默认值
defaultSubject
- 描述 : 在 简短描述 中是否使用显示默认值
- 类型 :
string
- 默认 :
""
- 使用 : 初始化补全模板,可使用 Tab 或者 → 进行快速补全;亦可直接使用 Enter 输出模板。
defaultBody
- 描述 : 在 详细描述 中是否使用显示默认值
- 类型 :
string
- 默认 :
""
- 使用 : 初始化补全模板,可使用 Tab 或者 → 进行快速补全;亦可直接使用 Enter 输出模板。
defaultFooterPrefix
- 描述 : 在 自定义ISSUE前缀 中是否使用显示默认值
- 类型 :
string
- 默认 :
""
- 使用 : 初始化补全模板,可使用 Tab 或者 → 进行快速补全;亦可直接使用 Enter 输出模板。
defaultIssues
- 描述 : 在 输入ISSUE 中是否使用显示默认值
- 类型 :
string
- 默认 :
""
- 使用 : 初始化补全模板,可使用 Tab 或者 → 进行快速补全;亦可直接使用 Enter 输出模板。