Skip to content

Use Grunt with documentation to generate great documentation for your JavaScript projects.

License

Notifications You must be signed in to change notification settings

documentationjs/grunt-documentation

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

51 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

grunt-documentation

Circle CI Greenkeeper badge

Use Grunt with documentation to generate great documentation for your JavaScript projects.

Getting Started

This plugin requires Grunt >=0.4.0

If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:

npm install grunt-documentation --save-dev

Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:

grunt.loadNpmTasks('grunt-documentation');

The "documentation" task

Overview

In your project's Gruntfile, add a section named documentation to the data object passed into grunt.initConfig().

grunt.initConfig({
    documentation: {
        default: {
            files: [{
                "expand": true,
                "cwd": "src",
                "src": ["**/*.js"]
            }],
            options: {
                destination: "docs"
            }
        },
    }
});

Options

options.destination

Type: String

The destination folder for the generated docs.

options.format

Type: String Default value: 'html'

Either 'html', 'md', 'json', or 'docset'.

options.filename

Type: String

Custom filename for md or json output.

options.access

Type: Array Default value: ['protected', 'public', 'undefined']

Include only comments with a given access level, out of private, protected, public and undefined. By default, public, protected and undefined access levels are included.

options.order

Type: Array Default value: []

An array defining explicit sort order.

options.theme

Type: String

Path to a custom theme.

options.name

Type: String

A custom project name to display in the generated documentation.

options.version

Type: String

A custom version string to display in the generated documentation.

Contributing

In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint your code using Grunt.

About

Use Grunt with documentation to generate great documentation for your JavaScript projects.

Resources

License

Stars

Watchers

Forks

Packages

No packages published