1.0.2 • Published 2 years ago

conventional-changelog-rabyte v1.0.2

Weekly downloads
-
License
MIT
Repository
-
Last release
2 years ago

一个changelog 生成规范工具

author: sonirjodxpro@live.com

  • 使用 redmine 或者其他工具管理项目,可以将 GitHub/GitLab 的 issues 地址替换成 bugsUrl 中的地址
  • 显示 commit 对应的提交人邮箱地址
  • 使用 emojis

前置插件准备

npm i commitizen cz-conventional-changelog conventional-changelog-cli --save-dev
npm install conventional-changelog-rabyte --save-dev

Configuration

在 package.json 中配置参数

不填配置的话则会按照 angular 的预设模版生成 CHANGELOG

{
  "scripts": {
    "commit": "git-cz && git push",
    "version": "conventional-changelog -p rabyte -i CHANGELOG.md -s -n && git add CHANGELOG.md"
  },
  "repository": {
    "type": "git",
    "url": "https://github.com/example.git"
  },
  "config": {
    "commitizen": {
      "path": "./node_modules/cz-conventional-changelog"
    }
  }
}

bugsUrl

Type: string Default: false

当你需要将 issues URL 替换成其他 URL 时,使用该参数,例如使用 redmine 管理项目, bugsUrl: 'https://redmine.example.com/issues/'

如果不填 bugsUrl 则会根据 package.json 中的 repository.url 来作为 issues URL

如果你使用了第三方的协作系统(例如 bitbucket), 推荐你使用这个插件 conventional-changelog-angular-bitbucket

emojis

Type: boolean Default: false

emojis types 参考 gitmoji

Commit TypeTitleDescriptionEmojis
featFeaturesA new feature
fixBug FixesA bug Fix🐛
docsDocumentationDocumentation only changes📝
styleStylesChanges that do not affect the meaning of the code (white-space, formatting, missing semi-colons, etc)💄
refactorCode RefactoringA code change that neither fixes a bug nor adds a feature♻️
perfPerformance ImprovementsA code change that improves performance⚡️
testTestsAdding missing tests or correcting existing tests
buildBuildChanges that affect the build system or external dependencies (example scopes: gulp, broccoli, npm)👷
ciContinuous IntegrationsChanges to our CI configuration files and scripts (example scopes: Travis, Circle, BrowserStack, SauceLabs)🔧
choreChoresOther changes that don't modify src or test files🎫
revertRevertsReverts a previous commit

Usage

生成 CHANGELOG 之前得 commit,记得在 master 主分支上发布版本,再生成 CHANGELOG,流程如下:

git add .

git commit -m "feat: init"

git push

npm version patch

git push --tags
1.0.2

2 years ago

1.0.1

2 years ago

1.0.0

2 years ago