sass-convert

[![npm version][npm-image]][npm-url]
[![Build Status][travis-image]][travis-url]
[![Coverage Status][coveralls-image]][coveralls-url]
[![Dependencies Status][depstat-image]][depstat-url]
[![License][license-image]][license-url]

> Node.js bindings to [sass-convert].

sass-convert is a library that provides binding for Node.js to [sass-convert],
the converter shipped with Sass. Integrates the converter in a stream pipeline.

Options

$3

type: String
The format to convert from. Can be css, scss, sass.

$3

type: String
The format to convert to. Can be scss or sass.

$3

type: Boolean
default: false
Continue the stream chain even if the converter is unable to work properly
(e.g.: no sass-convert binary found). Unconverted chunks/files won't be pushed
to the next pipe anyway.

$3

type: Boolean
default: false
Whether to change converted files extensions to to option (target format).
If you want more control over renaming, you should pipe [gulp-rename]
after the converter.

$3

type: Boolean
Convert underscores to dashes.

$3

type: Number|String
How many spaces to use for each level of indentation. Defaults to 2.
't' means use hard tabs.

$3

type: Boolean
Output the old-style :prop val property syntax.
Only meaningful when generating Sass.

$3

type: String
Specify the default encoding for input files.

$3

type: Boolean
Use Unix-style newlines in written files.
Always true on Unix.

Installation

``
npm i sass-convert --save
`

Requirements

You need to have Sass (Ruby Sass >=3.4.5) installed.
Either globally or locally with Bundler.




Usage

`js
var vfs = require('vinyl-fs');
var converter = require('sass-convert');

vfs.src('./input/*/.+(sass|scss|css)')
.pipe(converter({
from: 'sass',
to: 'scss',
}))
.pipe(vfs.dest('./output'));

`

`js
// sassdoc >= 2.0
var gulp = require('gulp');
var sassdoc = require('sassdoc');
var converter = require('sass-convert');

gulp.task('sassdoc', function () {
return gulp.src('./input/*/.+(sass|scss)')
.pipe(converter({
from: 'sass',
to: 'scss',
}))
.pipe(sassdoc());
});
`

`js
var fs = require('fs');
var vfs = require('vinyl-fs');
var source = require('vinyl-source-stream');
var rename = require('gulp-rename');

fs.createReadStream('./file.sass')
.pipe(source('file.sass'))
.pipe(converter({
from: 'sass',
to: 'scss',
}))
.pipe(rename('file.scss'))
.pipe(vfs.dest('./'));
``

Credits

* Pascal Duez
* Valérian Galliat
* Fabrice Weinberg
* Hugo Giraudel

Licence

sass-convert is unlicensed.

[sass-convert]: http://sass-lang.com/documentation/#executables
[gulp-rename]: https://github.com/hparra/gulp-rename

[npm-url]: https://www.npmjs.org/package/sass-convert
[npm-image]: http://img.shields.io/npm/v/sass-convert.svg?style=flat-square
[travis-url]: https://travis-ci.org/SassDoc/sass-convert?branch=master
[travis-image]: http://img.shields.io/travis/SassDoc/sass-convert.svg?style=flat-square
[coveralls-url]: https://coveralls.io/r/SassDoc/sass-convert
[coveralls-image]: https://img.shields.io/coveralls/SassDoc/sass-convert.svg?style=flat-square
[depstat-url]: https://david-dm.org/SassDoc/sass-convert
[depstat-image]: https://david-dm.org/SassDoc/sass-convert.svg?style=flat-square
[license-image]: http://img.shields.io/npm/l/sass-convert.svg?style=flat-square
[license-url]: LICENSE.md