contributor-faces
v1.1.0
Published
Put your contributors faces in your readme.
Downloads
1,216
Maintainers
Readme
contributor-faces
Put your contributors faces in your readme.
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
:
//
is only decorative and means it's a commentcontributor-faces
serves as the placeholder identifier.
Contributors
License
MIT © Nicolas Gryman