generator-badge

generator-badge

Generate badges for your readme

Installation

$ npm install --save --global generator-badge

Example

BEFORE

README.md:

# MY-AWESOME-PROJECT
<!-- badge -->
<!-- endbadge -->

THEN YOU DO

Terminal:

awesome-project$ badge install travis npm-version

WHAT YOU GET

README.md:

# MY-AWESOME-PROJECT
<!-- badge -->
[![travis](https://img.shields.io/travis/tanhauhau/awesome-project.svg)](https://travis-ci.org/tanhauhau/awesome-project)
[![npm-version](https://img.shields.io/npm/v/awesome-project.svg)](https://www.npmjs.com/package/awesome-project)
<!-- endbadge -->

Usage

Install badges

$ badge install <badges> [<args>]

You can specify required field values into arguments:

$ badge install travis --repo-username=tanhauhau --repo-name=awesome-project

For field values that is missing, badge will prompt you to enter.

$ badge install travis
  Inferring information needed...
  ? repo-username: tanhauhau
  ? repo-name: awesome-project
  Preparing the badges...
  Looking for README...
  Injecting badges into README...
  Done :)

List of all badges available

$ badge list <badges>

You can list all the badges available

$ badge list

Or list specified badges only

$ badge list apm tavis

Note typo in Travis.

Help

$ badge help <badge>
$ badge help travis
 travis-default
 Build apps with confidence.
 Description : Travis build status of master branch
 Fields      : repo-username, repo-name

Clear

$ badge clear

Remove all badges

Badges Available

See a list of badges available here.

Todo List

• Find README of various format: markdown, textile, rdoc, rst, pod, html
• Inferring git, svn repo information
• Storing global preferences, eg: able to remember author name in global
• Storing local preferences, eg: able to remember repo info in local package
• Filename as argument
• More badges available

Badge credits to

Contributing

• Fork it!
• Create your feature branch: git checkout -b my-new-feature
• Commit your changes: git commit -am 'Add some feature'
• Push to the branch: git push origin my-new-feature
• Submit a pull request :D

License

MIT