js-comments

Parse JavaScript code comments and generate API documentation.

js-comments

Parse JavaScript code comments and generate API documentation.

Please report any bugs or feature requests, thanks! Also, please note, custom filtering for comments is being implemented, but in the meantime only comments that have @api public will be rendered!

Install with npm

npm i js-comments --save-dev

Install with bower

bower install js-comments --save-dev

jsc

  • patterns {String}: Glob pattern or file paths to use.
  • dest {String}: Optional destination file path for generating relative links.
  • options {Object}
  • returns {String}: String of rendered markdown documentation.
var comments = require('js-comments');
var docs = comments(string);

See example output. See example code comments.

.parseFiles

  • patterns {String}: Glob pattern or file paths to use.
  • dest {String}: Optional destination file path for generating relative links.
  • options {Object}
  • returns {Array}: Returns an array of comments objects.

Expands the given glob patterns and creates a normalized comments object for each file in the array.

.render

  • context {Object}
  • options {Object}
  • returns {String}: Return the rendered string.

Render a template string with the given context. A custom lodash template may be passed on the options.

Jon Schlinkert

Copyright (c) 2014-2015 Jon Schlinkert
Originally modified from scrawl.js. Copyright (c) 2014 Caolan McMahon, contributors. Released under the MIT license


This file was generated by verb-cli on February 27, 2015.