hexo-renderer-bourbon

Sass renderer for Hexo with Bourbon support

An up-to-date node-sass wrapper that includes Bourbon mixins.

Install

$ npm i hexo-renderer-bourbon

Usage

To enable Bourbon support you need to import it in your stylesheet.

@import 'bourbon';

Options

This renderer supports all the options exposed by node-sass.

imagePath

imagePath is a String that represents the public image path. When using the image-url() function in a stylesheet, this path will be prepended to the path you supply. eg. Given an imagePath of /path/to/images, background-image: image-url('image.png') will compile to background-image: url("/path/to/images/image.png")

indentedSyntax

indentedSyntax is a Boolean flag to determine if Sass Indented Syntax should be used to parse provided string or a file.

omitSourceMapUrl

omitSourceMapUrl is a Boolean flag to determine whether to include sourceMappingURL comment in the output file.

outputStyle

outputStyle is a String to determine how the final CSS should be rendered. Its value should be one of 'nested' or 'compressed'. Node-sass defaults to 'nested'. ('expanded' and 'compact' are not currently supported by libsass).

precision

precision is a Number that will be used to determine how many digits after the decimal will be allowed. For instance, if you had a decimal number of 1.23456789 and a precision of 5, the result will be 1.23457 in the final CSS.

sourceComments

sourceComments is a Boolean flag to determine what debug information is included in the output file.

sourceMap

This must be true even for embeded sourcemaps.

outFile

Must put the name of the output css file for sourcemaps to work.

sourceMapEmbed

sourceMapEmbed is a Boolean flag to determine whether to embed sourceMappingUrl as data URI.

sourceMapContents

sourceMapContents is a Boolean flag to determine whether to include contents in maps.

Example _config.yml

bourbon:
  outputStyle: nested
  precision: 8
  imagePath: images
  sourceComments: none
  indentedSyntax: false
  omitSourceMapUrl: false
  sourceMap: false
  outFile: '',
  sourceMapEmbed: false
  sourceMapContents: false