gulp-sassdoc

gulp-sassdoc

SassDoc Gulp task.

This is a Gulp friendly plugin, not using streams.
Its goal is to make SassDoc integration in your Gulp workflow easier.

Getting Started

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

npm install --save-dev gulp-sassdoc

Documentation

See the Gulpfile in this repo for a full example.

SassDoc task

Run this task with the gulp sassdoc command.

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.

verbose

Type: Boolean
Default: false

Whether to enable SassDoc own logger or not.

config

Type: String
Default: null

Path to a view configuration file.

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.

display.watermark

Type: Boolean
Default: true

Enable/disable display of SassDoc watermark in footer.

package

Type: String | Object
Default: './package.json'

Pass your project informations to the generated view. Either a path to your package.json or an object.

Following keys will be looked for: title name version license homepage description

Heads up: If a config file is passed and found, its options will prevail over defauts. Additionnal options passed to the gulp 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.
gulp.task('sassdoc', function () {
  return gulp
    .src('path/to/sass')
    .pipe(sassdoc({
      dest: 'path/to/docs',
      verbose: true,
      config: 'path/to/view.json'
    }));
});

// Example with passed in options.
gulp.task('sassdoc', function () {
  return gulp
    .src('path/to/sass')
    .pipe(sassdoc({
      dest: 'path/to/docs',
      verbose: true,
      display: {
        access: ['public', 'private'],
        alias: true,
        watermark: true
      },
      package: './package.json'
    }));
});

Authors

Pascal Duez

Licence

gulp-sassdoc is unlicensed.