helper-apidocs

Template helper for automatically generating API docs from code comments. Should work with any template engine.

Install

Install with npm

1$ npm i helper-apidocs --save

Example usage

With Lo-Dash or Underscore:

1<%= apidocs("index.js") %>

With Handlebars:

1{{apidocs "index.js"}}

With Verb (lo-dash, with special delimiters to avoid delimiter collision in markdown docs):

1{%= apidocs('index.js') %};

Register the helper

This should work with any engine, here are a few examples

template

Register the helper for use with any template engine

1template.helper('apidocs', require('helper-apidocs'));

assemble

To register the helper for use with assemblev0.6.x:

1assemble.helper('apidocs', require('helper-apidocs'));

verb

Register the helper for use with verb:

1var verb = require('verb');
2verb.helper('apidocs', require('helper-apidocs'));
3
4verb.task('default', function() {
5  verb.src('.verb*.md')
6    .pipe(verb.dest('./'));
7});

handlebars

1var handlebars = require('handlebars');
2handlebars.registerHelper('apidocs', require('helper-apidocs'));

Lo-Dash or underscore

1// as a mixin
2_.mixin({apidocs: apidocsHelper});
3_.template('<%= _.apidocs("fixtures/*.js") %>', {});
4
5// passed on the context
6_.template('<%= apidocs("fixtures/*.js") %>', {apidocs: apidocsHelper});
7
8// as an import
9var settings = {imports: {apidocs: apidocsHelper}};
10_.template('<%= apidocs("fixtures/*.js") %>', {}, settings);

Running tests

Install dev dependencies:

1$ npm i -d && npm test

Contributing

Pull requests and stars are always welcome. For bugs and feature requests, please create an issue.

Author

Jon Schlinkert

• github/jonschlinkert
• twitter/jonschlinkert

License

Copyright © 2015 Jon Schlinkert Released under the MIT license.

---

This file was generated by verb on December 14, 2015.