Giter Club home page Giter Club logo

forked-gh-sauce's Introduction

gh-sauce octocat holding shaved ice

NPM version Build Status Dependency Status Coverage Status NPM downloads per month

Enhance your GitHub repo's markdown files.

$ cat CHANGELOG.md
# CHANGELOG

## 2.1.1 / 11 June 2015

- Bugfix for using values from view's context prototype #442 by @phillipj.
- Only display result of master branch on travis badge by @nikolas.
- Upgrade assertion library for proper string diffs #459 by @dasilvacontin.
$ gh-sauce CHANGELOG.md
# Dressing CHANGELOG.md with some gh-sauce...

- [x] "CHANGELOG.md" was dressed with gh-sauce

Done! 🍧
$ cat CHANGELOG.md
# CHANGELOG

## 2.1.1 / 11 June 2015

- Bugfix for using values from view's context prototype [#442] by [@phillipj].
- Only display result of master branch on travis badge by [@nikolas].
- Upgrade assertion library for proper string diffs [#459] by [@dasilvacontin].

[#442]: https://github.com/mochajs/mocha/issues/442
[#459]: https://github.com/mochajs/mocha/issues/459

[@dasilvacontin]: https://github.com/dasilvacontin
[@nikolas]: https://github.com/nikolas
[@phillipj]: https://github.com/phillipj

gh-sauce parses issues and usernames from markdown files and automatically converts them into links. Your markdown will remain clean and easy to read since the URLs will be listed (in alphanumeric order) at the end of the file.

Install

$ npm install -g gh-sauce

Usage

  Usage: gh-sauce [options] <file ...>

  Options:

    -h, --help             output usage information
    -V, --version          output the version number
    -s, --safe             Safe mode, doesn't overwrite existing urls
    -r, --repo <repo URL>  Provide default repo URL for issues

API

var sauce = require('gh-sauce')

var filename = 'CHANGELOG.md'

var sauceConfig = {
  // defaults to false
  safe: true
  // defaults to local package.json's homepage field
  repo: 'https://github.com/dasilvacontin/gh-sauce'
}

fs.readFile(filename, function (err, data) {
  var dressed = sauce.dress(data.toString(), sauceConfig)
  fs.writeFile(filename, dressed)
})

Contributing

In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using gulp.

License

MIT © David da Silva

"Octocat with shaved ice" drawing by Núria Balaguer

forked-gh-sauce's People

Contributors

dasilvacontin avatar j-f1 avatar formap avatar

Watchers

James Cloos avatar  avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.