Inserts badges into GitHub READMEs
npm install readme-badgerreadme-badger
=============
Whizzy badges in your READMEs.
Install
-------
npm install readme-badger
How To Use
----------
Returns the content but with a new badge inserted.
* content: the text content of a README.
* fileExt: the file extension of the README (md, textile, rdoc etc).
* imageUrl: the image url for the badge.
* linkUrl: the url for the badge to link to.
* altText: the alternative if images aren't visible. This will be used on its own for plaintext READMEs, so include a url in the text.
Returns true/false depending on whether the format (fileExt) will render a badge image or just the altText.
* fileExt: the file extension of the README (md, textile, rdoc etc)
Example
-------
``javascript
var badger = require('readme-badger');
var readme = '# My Lovely Library\n' +
'\n' +
'## Features\n';
var imageUrl = 'https://badges.gitter.im/Join%20Chat.svg';
var linkUrl = 'https://gitter.im/gitterHQ/gitter';
var altText = 'Join the chat at https://gitter.im/gitterHQ/gitter';
var readmeWithBadge = badger.addBadge(readme, 'md', imageUrl, linkUrl, altText);
console.log(readmeWithBadge);
// # My Lovely Library
//
// 
//
// ## Features
// ...
`
Format (fileExt) Support
--------------
readme-badger supports almost all of the GitHub README markups:
* markdown, mdown, mkdn, md
* textile
* rdoc
* org
* mediawiki, wiki
* rst
* asciidoc, adoc, asc
* pod
It will also failover to inserting the altText at the bottom of the README for any format that doesnt have image link support (creole, txt or anything else).
Building Locally
----------------
1. git clone git@github.com:gitterHQ/readme-badger.git
2.
3.
4.
License
-------
MIT