npm 包 chg 使用教程

阅读时长 3 分钟读完

什么是 npm 包 chg

chg 是一款 Node.js 的命令行工具,可以帮助前端开发人员更方便地管理项目中的 changelog。它可以通过监听 git 提交记录,自动生成 changelog,并支持自定义模板及发布到 GitHub Releases。

chg 具有以下特点:

  • 简单易用:只需要执行一个命令,changelog 便会自动生成。
  • 支持自定义模板:能够根据自己的需求,自定义 changelog 的格式。
  • 支持多种语言:支持中文、英文等多种语言。
  • 可以发布到 GitHub Releases:能够将 changelog 发布到 GitHub Releases,方便查看项目的变更历史。

如何使用 npm 包 chg

安装

首先,我们需要在项目中安装 chg 包,可以通过 npm 来进行安装:

配置

安装完成后,在项目根目录下创建 .chg.yml 文件,文件内容如下:

其中,template 指定了 changelog 的模板文件,output 指定了 changelog 的输出路径。

对于模板文件来说,可以使用以下变量:

  • {version}:当前版本号。
  • {date}:生成 changelog 的时间。
  • {commits}:所有提交的 commit 信息。
  • {feature}:所有 feature 类型的 commit 信息。
  • {fix}:所有 fix 类型的 commit 信息。
  • {chore}:所有 chore 类型的 commit 信息。
  • {docs}:所有 docs 类型的 commit 信息。
  • {refactor}:所有 refactor 类型的 commit 信息。
  • {style}:所有 style 类型的 commit 信息。
  • {test}:所有 test 类型的 commit 信息。

下面是一个示例模板文件:

-- -------------------- ---- -------
- ---------

-- ----------- - ------

---------
- ---------
---------
- ------
-----
- ------
-------
- --------------
------
- ----------
----------
- ------
-------
- ------
------
展开代码

执行命令

在配置文件准备好后,我们可以在控制台执行以下命令:

执行完命令后,chg 会根据配置文件自动生成一个 CHANGELOG.md 文件,其中包含了当前项目的 changelog。

小结

通过 chg 这个 npm 包,我们可以更加方便地管理项目的变更历史。使用 chg,不仅可以减少手动更新 changelog 的繁琐步骤,还可以通过自定义模板,生成符合自己需求的 changelog,为我们的项目带来更大的价值。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/68222

纠错
反馈

纠错反馈