all-contributors-cli/README.md

125 lines
4.6 KiB
Markdown
Raw Normal View History

2016-02-29 00:48:55 +00:00
# all-contributors-cli
<!-- CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
[![All Contributors](https://img.shields.io/badge/all_contributors-2-orange.svg?style=flat-square)](#contributors)
<!-- CONTRIBUTORS-BADGE:END -->
2016-02-29 00:48:55 +00:00
This is a tool to help automate adding contributor acknowledgements according to the [all-contributors](https://github.com/kentcdodds/all-contributors) specification.
2016-02-29 23:55:25 +00:00
## Installation
You can install it via `npm`:
```
npm install all-contributors-cli
```
2016-02-29 00:48:55 +00:00
## Configuration
2016-03-01 22:30:14 +00:00
### Create a `.all-contributorsrc` file
You must create a `.all-contributorsrc` JSON file. The data used to generate the contributors list will be stored in here, and you can configure how you want `all-contributors-cli` to generate the list.
```json
{
2016-03-01 22:30:14 +00:00
"file": "README.md",
"owner": "jfmengels",
"types": {
"cheerful": {
"symbol": ":smiley:"
}
},
"contributors": [{
"login": "jfmengels",
"...": "..."
}]
2016-02-29 08:21:34 +00:00
}
```
These are the keys you can specify:
- `file`: File to write the list of contributors in. Default: 'README.md'
2016-03-01 22:30:14 +00:00
- `projectOwner`: Name of the user the project is hosted by. Example: `jfmengels/all-contributor-cli` --> `jfmengels`. Mandatory.
- `projectName`: Name of the project. Example: `jfmengels/all-contributor-cli` --> `all-contributor-cli`. Mandatory.
- `types`: Specify custom symbols or link templates for contribution types. Can override the documented types.
- `imageSize`: Size (in px) of the user's avatar. Default: 100.
2016-03-01 22:30:14 +00:00
- `contributorsPerLine`: Maximum number of columns for the contributors table. Default: 7.
- `template`: Define your own template to generate the contributor list.
- `badgeTemplate`: Define your own template to generate the badge.
### Add contributors section
If you don't already have a Contributors section in a Markdown file, create one. Then add the comment tags section below to it. Don't worry, they're visible only to those that read the raw file. The tags **must** be at the beginning of the line, and each on their separate line.
```md
## Contributors
<!-- CONTRIBUTORS:START - Do not remove or modify this section -->
<!-- CONTRIBUTORS:END -->
```
If you wish to add a badge ( [![All Contributors](https://img.shields.io/badge/all_contributors-14-orange.svg?style=flat-square)](#contributors) ) indicating the number of collaborators, add the following tags (again, at the beginning of the line and each on their separate line):
```md
some-badge
<!-- CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
<!-- CONTRIBUTORS-BADGE:END -->
some-other-badge
```
2016-02-29 22:50:30 +00:00
2016-03-02 22:50:50 +00:00
## Usage
### Generating the contributors list
Use `generate` to generate the contributors list and inject it into your contributors file. Contributors will be read from your configuration file.
```
all-contributors generate
```
### Add new contributor
Use `add` to add new contributors to your project. They will be added to your configuration file. The contributors file will then be updated just as if you used the `generate` command.
```
# Add new contributor <username>, who made a contribution of type <contribution>
all-contributors add <username> <contribution>
# Example:
all-contributors add jfmengels code,doc
```
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: ✅
- translate: 🌍
- video: 📹
- talk: 📢
- design: 🎨
- review: 👀
2016-02-29 22:50:30 +00:00
## Contributors
Thanks goes to these wonderful people ([emoji key](https://github.com/kentcdodds/all-contributors#emoji-key)):
2016-03-01 22:30:14 +00:00
<!-- CONTRIBUTORS:START - Do not remove or modify this section -->
2016-03-02 22:50:50 +00:00
| [![Jeroen Engels](https://avatars.githubusercontent.com/u/3869412?v=3&s=100)<br /><sub>Jeroen Engels</sub>](https://github.com/jfmengels)<br />[💻](https://github.com/jfmengels/all-contributors-cli/commits?author=jfmengels) [📖](https://github.com/jfmengels/all-contributors-cli/commits?author=jfmengels) [⚠️](https://github.com/jfmengels/all-contributors-cli/commits?author=jfmengels) | [![Kent C. Dodds](https://avatars.githubusercontent.com/u/1500684?v=3&s=100)<br /><sub>Kent C. Dodds</sub>](http://kentcdodds.com/)<br />[📖](https://github.com/jfmengels/all-contributors-cli/commits?author=kentcdodds) |
| :---: | :---: |
2016-03-01 22:30:14 +00:00
<!-- CONTRIBUTORS:END -->
2016-02-29 22:50:30 +00:00
This project follows the [all-contributors](https://github.com/kentcdodds/all-contributors) specification.
Contributions of any kind welcome!
## LICENSE
MIT