|
| 1 | +[](https://www.npmjs.com/package/waos-conventional-changelog) [](https://travis-ci.org/WeAreOpenSourceProjects/waos-conventional-changelog) [](https://codeclimate.com/github/WeAreOpenSourceProjects/waos-conventional-changelog/maintainability) |
| 2 | + [](https://david-dm.org/WeAreOpenSourceProjects/waos-conventional-changelog) [](https://greenkeeper.io/) |
| 3 | + [](https://snyk.io/test/github/WeAreOpenSourceProjects/waos-conventional-changelog) |
| 4 | + |
| 5 | +[](https://weareopensource.me) [](mailto:weareopensource.me@gmail.com?subject=Join%20Slack&body=Hi,%20I%20found%20your%20community%20We%20Are%20Open%20Source.%20I%20would%20be%20interested%20to%20join%20the%20Slack%20to%20share%20and%20discuss%20about%20...%20,%20Thanks) [](mailto:weareopensource.me@gmail.com?subject=Contact) |
| 6 | + |
| 7 | + |
| 8 | +# Presentation |
| 9 | + |
| 10 | +Prompts for [conventional changelog](https://github.com/conventional-changelog/conventional-changelog) standard, based on [cz-conventional-changelog](https://github.com/commitizen/cz-conventional-changelog), which seems to be abandoned. For this reason, we decided to make our own package and included some PRs, switch to ES6 and add an Emoji system for some fun. |
| 11 | + |
| 12 | +PR included : |
| 13 | +* yinzara - [feat: implement subject feedback, scope filtering, subject filtering](https://github.com/commitizen/cz-conventional-changelog/pull/75) |
| 14 | + |
| 15 | + |
| 16 | + |
| 17 | +# Prerequisites |
| 18 | + |
| 19 | +Make sure you have installed all of the following prerequisites on your development machine: |
| 20 | + |
| 21 | +- Node.js (10.x) - [Download & Install Node.js](https://nodejs.org/en/download/) |
| 22 | + |
| 23 | +# Installation |
| 24 | + |
| 25 | +Global : |
| 26 | + |
| 27 | +```bash |
| 28 | +npm install --global commitizen waos-conventional-changelog |
| 29 | +``` |
| 30 | + |
| 31 | +Local : |
| 32 | + |
| 33 | +```bash |
| 34 | +npm install --global commitizen |
| 35 | +commitizen init waos-conventional-changelog --save-dev --save-exact |
| 36 | +``` |
| 37 | + |
| 38 | +# Integration |
| 39 | + |
| 40 | +We suggest to follow something like this : [How to create good commit messages](https://medium.com/@klauskpm/how-to-create-good-commit-messages-67943d30cced). Juste change cz-conventional-changelog part with waos-conventional-changelog |
| 41 | + |
| 42 | +## Configuration |
| 43 | + |
| 44 | +### package.json |
| 45 | + |
| 46 | +Like commitizen, you specify the configuration of cz-conventional-changelog through the package.json's `config.commitizen` key. |
| 47 | + |
| 48 | +```json5 |
| 49 | +{ |
| 50 | +// ... default values |
| 51 | + "config": { |
| 52 | + "commitizen": { |
| 53 | + "path": "./node_modules/cz-conventional-changelog", |
| 54 | + "maxHeaderWidth": 100, |
| 55 | + "maxLineWidth": 100, |
| 56 | + "defaultType": "", |
| 57 | + "defaultScope": "", |
| 58 | + "defaultSubject": "", |
| 59 | + "defaultBody": "", |
| 60 | + "defaultIssues": "" |
| 61 | + } |
| 62 | + } |
| 63 | +// ... |
| 64 | +} |
| 65 | +``` |
| 66 | +### Environment variables |
| 67 | + |
| 68 | +The following environment varibles can be used to override any default configuration or package.json based configuration. |
| 69 | + |
| 70 | +* CZ_TYPE = defaultType |
| 71 | +* CZ_SCOPE = defaultScope |
| 72 | +* CZ_SUBJECT = defaultSubject |
| 73 | +* CZ_BODY = defaultBody |
| 74 | +* CZ_MAX_HEADER_WIDTH = maxHeaderWidth |
| 75 | +* CZ_MAX_LINE_WIDTH = maxLineWidth |
| 76 | + |
| 77 | +### Commitlint |
| 78 | + |
| 79 | +If using the [commitlint](https://github.com/conventional-changelog/commitlint) js library, the "maxHeaderWidth" configuration property will default to the configuration of the "header-max-length" rule instead of the hard coded value of 100. This can be ovewritten by setting the 'maxHeaderWidth' configuration in package.json or the CZ_MAX_HEADER_WIDTH environment variable. |
| 80 | + |
| 81 | + |
| 82 | +# Licence |
| 83 | + |
| 84 | +[](/LICENSE.md) |
| 85 | + |
| 86 | +# Thanks |
| 87 | + |
| 88 | +[](https://www.patreon.com/pbrisorgueil) [](https://www.buymeacoffee.com/JrSa9tZGO) |
| 89 | + |
| 90 | + |
| 91 | +[](https://twitter.com/pbrisorgueil?lang=fr) [](https://www.youtube.com/channel/UCIIjHtrZL5-rFFupn7c3OtA) |
0 commit comments