Home

Awesome

contributor-faces

Put your contributors faces in your readme.

travis codecov

contributor-faces lets you display a list of your contributors in your readme. It also allows you to list contributors by contributions in javascript or html.

Install

npm install --save contributor-faces

Usage

API

import contributors from 'contributor-faces'

// get an array of contributors
contributors().then(...)

// get contributors list as html
contributors.render().then(...)

// update contributors list in readme
contributors.update().then(...)

// exclude some contributors
contributors('.', { exclude: '*-bot' }).then(...)

CLI

contributor-faces [<directory>]

Update your readme

To keep your contributor list up-to-date, your have to specify a placeholder for contributor-faces:

[//]: contributor-faces

Then whenever you update your readme, the placeholder will get updated like this:

[//]: contributor-faces
<a href="https://github.com/ngryman"><img src="https://avatars.githubusercontent.com/u/892048?v=3" title="ngryman" width="80" height="80"></a>
[//]: contributor-faces

FAQ

Why [//]: contributor-faces?

markdown does not officially support non visible text or comments. A known workaround is to use a link label to do so. contributor-faces uses a specific link label to process your readme:

Contributors

<a href="https://github.com/ngryman"><img src="https://avatars.githubusercontent.com/u/892048?v=3" title="ngryman" width="80" height="80"></a>

License

MIT © Nicolas Gryman