redok
v0.2.0
Published
Readme and documentation generator
Downloads
69
Readme
redok
Readme and documentation generator
redok is a tool for generating README and repo documentation using Handlebars and Markdown, and aims to speed up the most common tasks.
Installation
$ npm install -g redokUsage
Generate output files for all templates in the folder .docs. For example, .docs/README.md would become your project's main readme file.
$ redokOptions
It is possible to pass options to the command line tool.
Load templates and partials from .alternate/
$ redok --dir .alternateWatch and regenerate on change
$ redok --watchPartials
If your readme is growing, it's smart to split the template up into smaller chunks. All .hbs files in .docs/partials are available as Handlebars partials:
{{>foo}}Badges
redok comes with a few built-in partials for generating badges.
|Description|Code|Example|
|---|---|---|
|Gitter chat|{{>badges/gitter}};||
|npm version|
{{>badges/npm-version}}| |
|npm downloads|
{{>badges/npm-downloads}}||
|npm dependencies|
{{>badges/npm-dependencies}}||
|npm devDependencies|
{{>badges/npm-devDependencies}}||
|Github stars|
{{>badges/github-stars}}||
|Github forks|
{{>badges/github-forks}}||
|Travis CI status|
{{>badges/travis}}||
|CodeClimate score|
{{>badges/codeclimate-score}}||
|CodeClimate coverage|
{{>badges/codeclimate-coverage}}||
License
MIT © 2015 Adam Renklint
Generated with redok @ Friday June 12th, 2015 - 11:04:19 AM
