README
gulp-apidoc
Generates a RESTful web API Documentationusing the apidoc library.
How It Works
/path/api/stuff.js
:
/**
* @api {get} /user/:id Request User information
* @apiName GetUser
* @apiGroup User
*
* @apiParam {Number} id Users unique ID.
*
* @apiSuccess {String} firstname Firstname of the User.
* @apiSuccess {String} lastname Lastname of the User.
*/
Install
Install with npm
npm install --save-dev gulp-apidoc
Usage
var gulp = require('gulp'),
apidoc = require('gulp-apidoc');
gulp.task('apidoc', function(done){
apidoc({
src: "example/",
dest: "build/"
},done);
});
With options:
var gulp = require('gulp'),
apidoc = require('gulp-apidoc');
gulp.task('apidoc',function(done){
apidoc({
src: "example/",
dest: "build/",
template: "template/",
debug: true,
includeFilters: [ ".*\\.js