npm

Need private packages and team management tools?Check out npm Orgs. »

gulpdoc

1.1.6 • Public • Published

gulpdoc

NpmVersion Build Status dependencies Status devDependencies Status Greenkeeper badge

Documentation generator for Gulp tasks.

Quick start

Install

Locally to use in code:

npm install gulpdoc

Or globally to use in shell:

npm install -g gulpdoc

Use

For example your javascript files containing Gulp tasks are located in the ./gulp/ directory relative to the current.

Annotate Gulp tasks with @gulptask (case insensitive) and place descriptions like this:

/**
 * Gulp task described in block comment before the annotation.
 * @gulptask example:block
 */
gulp.task('example:block', function() {
  // Insanely useful actions.
});
// @gulptask example:line Gulp task described in line comment on the annotation line.
gulp.task('example:line', function() {
  // Insanely useful actions.
});

Сode

const gulpdoc = require('gulpdoc');
const tasks = gulpdoc.getTasks('./gulp/*.js');
console.log(tasks);
// Outputs:
// [ Task { name: 'example:block', description: 'Gulp task described in block comment before the annotation.' },
//   Task { name: 'example:line', description: 'Gulp task described in line comment on the annotation line.' } ]

Shell

gulpdoc ./gulp/*.js

or

gulpdoc -s ./gulp/*.js -d ./gulpdoc.md -a gulptask

Where -s is source, -d is destination and -a is annotation.

It'll make following gulpdoc.md:

  • gulp example:block - Gulp task described in block comment before the annotation.
  • gulp example:line - Gulp task described in line comment on the annotation line.

API

Gulpdoc

Gulpdoc class.

Kind: global class


getTasks(pattern, [annotation], [options])Array.<Task>

Get tasks.

Kind: static method of Gulpdoc

Returns: Array.<Task>, where Task object contains name and description properties

Parameter Type Default Description
pattern string Glob pattern
[annotation] string 'gulptask' Annotation
[options] Object {} Glob options

install

npm i gulpdoc

Downloadsweekly downloads

47

version

1.1.6

license

MIT

homepage

github.com

repository

Gitgithub

last publish

collaborators

  • avatar
Report a vulnerability