helper-apidocs
Template helper for automatically generating API docs from code comments. Should work with any template engine.
Last updated 5 years ago by jonschlinkert .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install helper-apidocs 
SYNC missed versions from official npm registry.

helper-apidocs NPM version Build Status

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

Install

Install with npm

$ npm i helper-apidocs --save

Example usage

With Lo-Dash or Underscore:

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

With Handlebars:

{{apidocs "index.js"}}

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

{%= 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

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

assemble

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

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

verb

Register the helper for use with verb:

var verb = require('verb');
verb.helper('apidocs', require('helper-apidocs'));

verb.task('default', function() {
  verb.src('.verb*.md')
    .pipe(verb.dest('./'));
});

handlebars

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

Lo-Dash or underscore

// as a mixin
_.mixin({apidocs: apidocsHelper});
_.template('<%= _.apidocs("fixtures/*.js") %>', {});

// passed on the context
_.template('<%= apidocs("fixtures/*.js") %>', {apidocs: apidocsHelper});

// as an import
var settings = {imports: {apidocs: apidocsHelper}};
_.template('<%= apidocs("fixtures/*.js") %>', {}, settings);

Running tests

Install dev dependencies:

$ 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

License

Copyright © 2015 Jon Schlinkert Released under the MIT license.


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

Current Tags

  • 0.5.1                                ...           latest (5 years ago)

12 Versions

  • 0.5.1                                ...           5 years ago
  • 0.5.0                                ...           5 years ago
  • 0.4.1                                ...           5 years ago
  • 0.4.0                                ...           5 years ago
  • 0.3.0                                ...           5 years ago
  • 0.2.1                                ...           6 years ago
  • 0.2.0                                ...           6 years ago
  • 0.1.4                                ...           6 years ago
  • 0.1.3                                ...           6 years ago
  • 0.1.2                                ...           6 years ago
  • 0.1.1                                ...           6 years ago
  • 0.1.0                                ...           6 years ago
Maintainers (1)
Downloads
Today 12
This Week 37
This Month 100
Last Day 12
Last Week 63
Last Month 264
Dependencies (7)
Dev Dependencies (7)

Copyright 2014 - 2016 © taobao.org |