cz-conventional-changelog-befe

cz adaptor for baidu BEFE

cz-conventional-changelog-befe 是为 BEFE 团队定制的 commitizen 适配器.

可以通过友好交互(问答式)提交符合规范的 commit message.

特性

生成 BEFE 团队风格的 commit message
友好问答
支持 icafe / gitlab / github suggest 补全卡片
记录上次的交互输入值
国际化支持（默认使用当前系统语言：中文或英文）

主流规范 vs BEFE 规范

# types is BEFE's standard
<type>(<scope>): <subject>

<body>

<footer>

主要区别

types: 是 BEFE 团队定制的 types from conventional-commit-types-befe
issues: 提示输入 icafe card ID, 会自动补全前缀
简要描述和关联卡片输入框支持 icafe suggest
(如输入 '#{关键字(可以是 id 或者 title 等等)}' 或者带有明确 icafe spaceId，如 'icafe-api-{关键字}')
支持输入值交互的保存（详见inquirer-store）
使用 git cz --read 来使得上一次保存值生效

生成的 commit message 示例

feat(邮件模块): 富文本输入框添加变量的 mention 功能

mention 功能并未使用第三方库

fix hcm-123,hcm-234,hcm-345

使用

全局使用

npm install -g commitizen
npm install -g cz-conventional-changelog-befe
echo '{ "path": "cz-conventional-changelog-befe" }' > ~/.czrc

当前项目使用

npm install -g commitizen
npm install cz-conventional-changelog-befe

在项目根 package.json 中配置

...
  "config": {
    "commitizen": {
      "path": "cz-conventional-changelog-befe"
    }
  }

在项目中执行 git cz

git cz --retry：跳过问答式交互，直接以上一次的提交 message 进行提交
git cz --read: 使用 git cz --read 来使得上一次交互输入值成为默认值

文档

在具有卡片提示功能的简要描述字段中，卡片提示补全功能有两种用法:

补全卡片号：输入 # 开头，tab 键补全卡片号
补全卡片标题（只在简要描述字段中）：输入任意非 # 开头文本，tab 键补全卡片标题

其他的卡片提示字段则只能补全卡片号

Debugger

# 只调试 cz
DEBUG=cz-conventional-changelog-befe git cz

# icafe-api 调试也开启
DEBUG=cz-conventional-changelog-befe,icafe-api* git cz

Examples

git clone https://github.com/be-fe/cz-conventional-changelog-befe.git
cd cz-conventional-changelog-befe

npm i
npm run example
npm run example [type] # type 对应 examples 下的例子，如 github

样例项目

icode commit-demo

be-fe / cz-conventional-changelog-befe

readme