Integrates jsdoc3 generation into your Grunt build
This plugin enables you to integrate generation of comment based documentation into your Grunt build.
You also need
java installed and a valid
JAVA_HOME environment variable set.
Install this grunt plugin next to your project's grunt.js gruntfile with:
npm install grunt-jsdoc-plugin`
Configure the plugin to your project's grunt.js gruntfile:
First, add the
jsdoc entry to the options of the
initConfig method :
gruntinitConfigjsdoc :dist :src: 'src/*.js' 'test/*.js'dest: 'doc';
The only supported options are
src: an array of pattern that matches the files to extract the documentation from. You can also add the pattern to a README.md file to include it in your doc as described there.
dest: the directory where the documentation will be generated (it will be created if needed).
config: (optional) a path to a jsdoc config file (refer the usejsdoc documentation below for more information).
Then, load the plugin
To generate the documentation, you need to call the
jsdoc task :
$> grunt jsdoc
or integrate it to your build sequence :
gruntregisterTask'default' 'lint test jsdoc';
Any contribution is welcome! Please check the issues.
Copyright (c) 2012 Bertrand Chevrier
Licensed under the MIT license.