release-it-free-changelog 👋

An extension based on @release-it/conventional-changelog that allows users to rewrite log content and provides a log topic by default

🏠 Homepage

Prerequisites

• node >=14

Install

1yarn add release-it-free-changelog -D

Usage

In the release-it config, for example:

1"plugins": {
2  "release-it-free-changelog": {}
3}

Configuration

preset

The default configuration:

1{
2  "preset": {
3    "name": "conventionalcommits",
4    "types": [
5      {
6        "type": "feat",
7        "section": "✨ Features | 新功能"
8      },
9      {
10        "type": "fix",
11        "section": "🐛 Bug Fixes | Bug 修复"
12      },
13      {
14        "type": "chore",
15        "section": "🚀 Chore | 构建/工程依赖/工具",
16        "hidden": true
17      },
18      {
19        "type": "docs",
20        "section": "📝 Documentation | 文档"
21      },
22      {
23        "type": "style",
24        "section": "💄 Styles | 样式"
25      },
26      {
27        "type": "refactor",
28        "section": "♻️ Code Refactoring | 代码重构"
29      },
30      {
31        "type": "perf",
32        "section": "⚡ Performance Improvements | 性能优化"
33      },
34      {
35        "type": "test",
36        "section": "✅ Tests | 测试",
37        "hidden": true
38      },
39      {
40        "type": "revert",
41        "section": "⏪ Revert | 回退",
42        "hidden": true
43      },
44      {
45        "type": "build",
46        "section": "📦‍ Build System | 打包构建"
47      },
48      {
49        "type": "ci",
50        "section": "👷 Continuous Integration | CI 配置"
51      }
52    ]
53  }
54}

Or you can also use one of:

• angular
• atom
• codemirror
• conventionalcommits
• ember
• eslint
• express
• jquery
• jscs
• jshintOr you can also

If you want to customize the configuration, you can refer to Conventional Changelog Configuration Spec (v2.1.0) for the configuration object to pass as preset.

changelogFile

Default value: CHANGELOG.md

Set a filename as changelogFile to write the changelog to.

header

Set the main header for the changelog document:

1"plugins": {
2  "release-it-free-changelog": {
3    "header": "# Changelog",
4  }
5}

rewriteChangelog

Default value: false

If set to true, you can rewrite the log content，as shown below:

authorName

Default value: true

If set to false, the submitter of each commit will not be displayed

context

Default value: undefined

This option will be passed as the second argument (context) to conventional-changelog-core, for example:

1"plugins": {
2  "release-it-free-changelog": {
3    "context": {
4      "data": {
5        "name": "eric"
6      }
7    }
8  }
9}

gitRawCommitsOpts

Default value: undefined

Options for git-raw-commits. For example, you can use the following option to include merge commits into changelog:

1{
2  "plugins": {
3    "release-it-free-changelog": {
4      "gitRawCommitsOpts": {
5        "merges": null
6      }
7    }
8  }
9}

parserOpts

Default value: undefined

Options for conventional-commits-parser. For example, you can use the following option to set the merge pattern during parsing the commit message:

1{
2  "plugins": {
3    "release-it-free-changelog": {
4      "parserOpts": {
5        "mergePattern": "^Merge pull request #(\\d+) from (.*)$"
6      }
7    }
8  }
9}

writerOpts

Default value: undefined

Options for conventional-changelog-writer. For example, you can use the following option to group the commits by 'scope' instead of 'type' by default.

1{
2  "plugins": {
3     "release-it-free-changelog": {
4      "writerOpts": {
5        "groupBy:" "scope"
6      }
7    }
8  }
9}

If you want to customize the templates used to write the changelog, you can do it like in a .release-it.js file like so:

1const fs = require('fs')
2
3const commitTemplate = fs.readFileSync('commit.hbs').toString()
4
5module.exports = {
6  plugins: {
7    'release-it-free-changelog': {
8      writerOpts: {
9        commitPartial: commitTemplate
10      }
11    }
12  }
13}

🌸 Thanks

This project is heavily inspired by the following awesome projects.

• release-it
• @release-it/conventional-changelog

🤝 Contributing

Contributions, issues and feature requests are welcome!
Feel free to check issues page. You can also take a look at the contributing guide.

Show your support

Give a ⭐️ if this project helped you!

📝 License

Copyright © 2022 ericwan ericwan2021@163.com.
This project is MIT licensed.