grunt-sassdoc

grunt-sassdoc

SassDoc grunt task.

Getting Started

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, install this plugin with this command:

npm install --save-dev grunt-sassdoc

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

grunt.loadNpmTasks('grunt-sassdoc');

Tip: the load-grunt-tasks module makes it easier to load multiple grunt tasks.

Documentation

See the Gruntfile in this repo for a full example.

SassDoc task

Run this task with the grunt sassdoc command.

Task targets, files and options may be specified according to the grunt Configuring tasks guide.

Options

Any specified option will be passed through directly to SassDoc, thus you can specify any option that SassDoc supports. See the SassDoc documentation for a list of supported options.

config

Type: String
Default: null

Path to a view configuration file.

title

Type: String
Default: 'SassDoc'

Generated documentation page title.

version

Type: String | false
Default: null

Whether to display project version next to the page title.

display_access

Type: Array
Default: ['public', 'private']

Access levels that should be displayed.

display_alias

Type: Boolean
Default: false

Enable/disable display of alias items.

Heads up: If a config file is passed and found, its options will prevail over defauts. Additionnal options passed to the grunt task, will complement it but not override it. You should really manage your options in one place.

Config examples

// Example with external view configuration file.
grunt.initConfig({
  sassdoc: {
    default: {
      src: 'path/to/sass',
      dest: 'path/todocs',
      options: {
        config: 'path/to/view.json'
      }
    }
  },
});

// Example with passed in options.
grunt.initConfig({
  sassdoc: {
    default: {
      src: 'path/to/sass',
      dest: 'path/to/docs',
      options: {
        title: 'My cool project'
        version: 'v1.5.0'
        display_access: ['public'],
        display_alias: true
      }
    }
  },
});

Authors

Pascal Duez

Licence

grunt-sassdoc is unlicensed.