sassdoc

SassDoc

SassDoc. Like JSDoc, but for Sass files.

Currently only work for .scss files. Also, inline comments are not parsed (//).

Example

Function/mixin

/**
 * Adds `$value` at `$index` in `$list`.
 *
 * @author Hugo Giraudel
 *
 * @ignore Documentation: http://sassylists.com/documentation/#insert-nth
 *
 * @requires is-true
 *
 * @param {List}   $list  - list to update
 * @param {Number} $index - index to add
 * @param {*}      $value - value to add
 *
 * @throws List index $index is not a number for `insert-nth`.
 * @throws List index $index must be a non-zero integer for `insert-nth`.
 *
 * @return {List | Null}
 */

@function insert-nth($list, $index, $value) {
  // ...
}

Variable

/**
 * Defines whether the lib should support legacy browsers (e.g. `IE 8`).
 * ---
 * @since 0.3.9
 * @todo Nothing. It's awesome.
 * @link https://github.com/HugoGiraudel/SassDoc SassDoc
 * @datatype Bool
 */
$legacy-support: true !global;

Preview

Installation

NPM

npm install -g sassdoc

Grunt

See grunt-sassdoc.

Usage

Command line

sassdoc <src> <dest> [options]

Arguments:

1. <src> Path to your Sass folder.
2. <dest> Path to the destination folder.

Options:

• -h, --help: bring help
• -v, --verbose: run in verbose mode
• -c, --config: path to .json file containing variables to be passed to the view

Node

var sassdoc = require('sassdoc');

sassdoc.parse(__dirname + '/sass').then(function (items) {
  console.log(items);
})

Documentation

See Wiki.

Pass extra variables to the view

With the -c or --config flag, you can set the path to a JSON file containing variables to be passed to the view so the latter is a little more customized than the default documentation.

Default path leads to the view.json file at root level. You can update this file or make your own.

Allowed variables:

• (String) title: title of the page
• (Object) display: see below
• (Boolean) display.private: enable/disable display of private items
• (Boolean) display.alias: enable/disable display of alias items

Credits

• Valérian Galliat
• Fabrice Weinberg
• Hugo Giraudel