docs: Updated README
BREAKING CHANGE: `package-json` is now renamed to `version-file`releases/v3
parent
2f1b568e89
commit
000434c446
55
README.md
55
README.md
|
@ -6,12 +6,18 @@ This action will bump version, tag commit and generate a changelog with conventi
|
||||||
|
|
||||||
- **Required** `github-token`: Github token.
|
- **Required** `github-token`: Github token.
|
||||||
- **Optional** `git-message`: Commit message that is used when committing the changelog.
|
- **Optional** `git-message`: Commit message that is used when committing the changelog.
|
||||||
|
- **Optional** `git-user-name`: The git user.name to use for the commit. Default `Conventional Changelog Action`
|
||||||
|
- **Optional** `git-user-email`: The git user.email to use for the commit. Default `conventional.changelog.action@github.com`
|
||||||
|
- **Optional** `git-pull-method`: The git pull method used when pulling all changes from remote. Default `--ff-only`
|
||||||
- **Optional** `preset`: Preset that is used from conventional commits. Default `angular`.
|
- **Optional** `preset`: Preset that is used from conventional commits. Default `angular`.
|
||||||
- **Optional** `tag-prefix`: Prefix for the git tags. Default `v`.
|
- **Optional** `tag-prefix`: Prefix for the git tags. Default `v`.
|
||||||
- **Optional** `output-file`: File to output the changelog to. Default `CHANGELOG.md`, when providing `'false'` no file will be generated / updated.
|
- **Optional** `output-file`: File to output the changelog to. Default `CHANGELOG.md`, when providing `'false'` no file will be generated / updated.
|
||||||
- **Optional** `release-count`: Number of releases to preserve in changelog. Default `5`, use `0` to regenerate all.
|
- **Optional** `release-count`: Number of releases to preserve in changelog. Default `5`, use `0` to regenerate all.
|
||||||
- **Optional** `package-json`: The path to the package.json to use. Default `./package.json`.
|
- **Optional** `version-file`: The path to the file that contains the version to bump. Default `./package.json`.
|
||||||
|
- **Optional** `version-path`: The place inside the version file to bump. Default `version`.
|
||||||
- **Optional** `skip-on-empty`: Boolean to specify if you want to skip empty release (no-changelog generated). This case occured when you push `chore` commit with `angular` for example. Default `'false'`.
|
- **Optional** `skip-on-empty`: Boolean to specify if you want to skip empty release (no-changelog generated). This case occured when you push `chore` commit with `angular` for example. Default `'false'`.
|
||||||
|
- **Optional** `skip-version-file`: Do not update the version file. Default `'false'`.
|
||||||
|
- **Optional** `skip-commit`: Do create a release commit. Default `'false'`.
|
||||||
|
|
||||||
## Outputs
|
## Outputs
|
||||||
|
|
||||||
|
@ -27,7 +33,7 @@ Uses all the defaults
|
||||||
|
|
||||||
```yaml
|
```yaml
|
||||||
- name: Conventional Changelog Action
|
- name: Conventional Changelog Action
|
||||||
uses: TriPSs/conventional-changelog-action@v2
|
uses: TriPSs/conventional-changelog-action@v3
|
||||||
with:
|
with:
|
||||||
github-token: ${{ secrets.github_token }}
|
github-token: ${{ secrets.github_token }}
|
||||||
```
|
```
|
||||||
|
@ -36,34 +42,49 @@ Overwrite everything
|
||||||
|
|
||||||
```yaml
|
```yaml
|
||||||
- name: Conventional Changelog Action
|
- name: Conventional Changelog Action
|
||||||
uses: TriPSs/conventional-changelog-action@v2
|
uses: TriPSs/conventional-changelog-action@v3
|
||||||
with:
|
with:
|
||||||
github-token: ${{ secrets.github_token }}
|
github-token: ${{ secrets.github_token }}
|
||||||
git-message: 'chore(release): {version}'
|
git-message: 'chore(release): {version}'
|
||||||
|
git-user-name: 'Awesome Changelog Action'
|
||||||
|
git-user-email: 'awesome_changelog@github.actions.com'
|
||||||
preset: 'angular'
|
preset: 'angular'
|
||||||
tag-prefix: 'v'
|
tag-prefix: 'v'
|
||||||
output-file: 'CHANGELOG.md'
|
output-file: 'MY_CUSTOM_CHANGELOG.md'
|
||||||
release-count: '5'
|
release-count: '10'
|
||||||
package-json: './package.json'
|
version-file: './my_custom_version_file.json' // or .yml, .yaml, .toml
|
||||||
|
version-path: 'path.to.version'
|
||||||
skip-on-empty: 'false'
|
skip-on-empty: 'false'
|
||||||
|
skip-version-file: 'false'
|
||||||
|
skip-commit: 'false'
|
||||||
```
|
```
|
||||||
|
|
||||||
No file changelog
|
No file changelog
|
||||||
|
|
||||||
```yaml
|
```yaml
|
||||||
- name: Conventional Changelog Action
|
- name: Conventional Changelog Action
|
||||||
uses: TriPSs/conventional-changelog-action@v2
|
uses: TriPSs/conventional-changelog-action@v3
|
||||||
with:
|
with:
|
||||||
github-token: ${{ secrets.github_token }}
|
github-token: ${{ secrets.github_token }}
|
||||||
output-file: 'false'
|
output-file: 'false'
|
||||||
```
|
```
|
||||||
|
|
||||||
|
Tag only
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
- name: Conventional Changelog Action
|
||||||
|
uses: TriPSs/conventional-changelog-action@v3
|
||||||
|
with:
|
||||||
|
github-token: ${{ secrets.github_token }}
|
||||||
|
skip-commit: 'true'
|
||||||
|
```
|
||||||
|
|
||||||
Github releases
|
Github releases
|
||||||
|
|
||||||
```yaml
|
```yaml
|
||||||
- name: Conventional Changelog Action
|
- name: Conventional Changelog Action
|
||||||
id: changelog
|
id: changelog
|
||||||
uses: TriPSs/conventional-changelog-action@v2
|
uses: TriPSs/conventional-changelog-action@v3
|
||||||
with:
|
with:
|
||||||
github-token: ${{ secrets.github_token }}
|
github-token: ${{ secrets.github_token }}
|
||||||
output-file: 'false'
|
output-file: 'false'
|
||||||
|
@ -79,3 +100,21 @@ Github releases
|
||||||
release_name: ${{ steps.changelog.outputs.tag }}
|
release_name: ${{ steps.changelog.outputs.tag }}
|
||||||
body: ${{ steps.changelog.outputs.clean_changelog }}
|
body: ${{ steps.changelog.outputs.clean_changelog }}
|
||||||
```
|
```
|
||||||
|
|
||||||
|
## Development
|
||||||
|
If you'd like to contribute to this project, all you need to do is clone and install [act](https://github.com/nektos/act) this project and run:
|
||||||
|
|
||||||
|
```shell
|
||||||
|
$ yarn install
|
||||||
|
|
||||||
|
# We need the full 18 gb image because we use GIT
|
||||||
|
$ act -P ubuntu-latest=nektos/act-environments-ubuntu:18.04 -s github_token=<your token>
|
||||||
|
```
|
||||||
|
|
||||||
|
## [License](./LICENSE)
|
||||||
|
|
||||||
|
Conventional Changelog Action is [MIT licensed](./LICENSE).
|
||||||
|
|
||||||
|
## Collaboration
|
||||||
|
|
||||||
|
If you have questions or [issues](https://github.com/TriPSs/conventional-changelog-action/issues), please [open an issue](https://github.com/TriPSs/conventional-changelog-action/issues/new)!
|
||||||
|
|
Loading…
Reference in New Issue