grunt-jsdoc-plugin

Integrates jsdoc3 generation into your Grunt build

Usage no npm install needed!

<script type="module">
  import gruntJsdocPlugin from 'https://cdn.skypack.dev/grunt-jsdoc-plugin';
</script>

README

grunt-jsdoc-plugin

This plugin enables you to integrate generation of comment based documentation into your Grunt build.

Install

You need grunt as well as node and npm installed and running on your system.

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`

Documentation

Configuration

Configure the plugin to your project's grunt.js gruntfile:

First, add the jsdoc entry to the options of the initConfig method :

grunt.initConfig({
    jsdoc : {
        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 dest: the directory where the documentation will be generated (it will be created if needed).

Then, load the plugin

grunt.loadNpmTasks('grunt-jsdoc-plugin');

Documentation

The current version supports only jsdoc3 documentation style. The sources configured must contains valid jsdoc3 tags. Consult the [usejdoc] website for the details.

Build

To generate the documentation, you need to call the jsdoc task :

gt; grunt jsdoc

or integrate it to your build sequence :

grunt.registerTask('default', 'lint test jsdoc');

Contributing

Any contribution is welcome! Please check the issues.

Release History

  • 0.1.0 First release, includes basic support of jsdoc3

License

Copyright (c) 2012 Bertrand Chevrier
Licensed under the MIT license.