all-contributors-cli/README.md

47 lines
1.4 KiB
Markdown
Raw Normal View History

2016-02-29 00:48:55 +00:00
# all-contributors-cli
This is a tool to help automate adding contributor acknowledgements according to the [all-contributors](https://github.com/kentcdodds/all-contributors) specification.
## Usage
2016-02-29 08:21:34 +00:00
```
all-contributors <username> <contribution>
```
Where:
- `username` is the user's GitHub username
- `contribution` is a ';'-separated list of ways to contribute, from the following list ([see the specs](https://github.com/kentcdodds/all-contributors#emoji-key)):
- code: 💻
- plugin: 🔌
- tool: 🔧
- doc: 📖
- question: ❓
- test: ⚠️
- bug: 🐛
- example: 💡
- blog: 📝
- tutorial: ✅
- video: 📹
- talk: 📢
- design: 🎨
2016-02-29 00:48:55 +00:00
## Configuration
2016-02-29 08:21:34 +00:00
You can configure the project by creating a `.all-contributors` JSON file.
```json
{
"file": "README.md",
"owner": "jfmengels",
"emoji": {
"thoughtleadering": "some emoji"
}
}
```
These are the keys you can specify:
- TODO `file`: File to write the list of contributors in. Default: 'README.md'
- TODO `owner`: Name of the user the project is hosted by. Example: `jfmengels/all-contributor-cli` --> `jfmengels`. By default will be parsed from the repo's homepage in `package.json`.
- TODO `project`: Name of the project. Default: Name of the project written in the `package.json` file.
- TODO `imageSize`: Size (in px) of the user's avatar. Default: 100.
- TODO `emoji`: Specify custom emoji, can override the existing override.