conventional-changelog-action/README.md

36 lines
1.1 KiB
Markdown

# Conventional Changelog action
This action will bump version, tag commit and generate a changelog with conventional commits.
## Inputs
- **Required** `github-token`: Github token.
- **Optional** `git-message`: Commit message that is used when committing the changelog.
- **Optional** `preset`: Preset that is used from conventional commits. Default `angular`.
- **Optional** `tag-prefix`: Prefix for the git tags. Default `v`.
- **Optional** `output-file`: File to output the changelog to. Default `CHANGELOG.md`.
- **Optional** `release-count`: Number of releases to preserve in changelog. Default `5`, use `0` to regenerate all.
## Example usages
Uses all the defaults
```yaml
- name: Conventional Changelog Action
uses: TriPSs/conventional-changelog-action@v2.0.1
with:
github-token: ${{ secrets.github_token }}
```
Overwrite everything
```yaml
- name: Conventional Changelog Action
uses: TriPSs/conventional-changelog-action@v2.0.1
with:
github-token: ${{ secrets.github_token }}
git-message: 'chore(release): {version}'
preset: 'angular'
tag-prefix: 'v'
output-file: 'CHANGELOG.md'
release-count: '5'
```