Never Poke Monkeys

    This package has been deprecated

    Author message:

    No longer maintained

    grunt-libsass

    0.2.1 • Public • Published

    No Longer Maintained.

    This project was built as an attempt to fit libsass into our build process at project collins more comfortably than grunt-sass but at the time libsass had not reached a level of feature parity which would allow it to use it. While that may no longer be the case I don't have time right now to come back to this project. It's not quite dead, but definitely sleeping.

    For fast sass compilation with libsass look at grunt-sass which is an actively maintained grunt sass compiler using libsass

    grunt-libsass

    Fast grunt sass compiler using libsass via node-sass

    Getting Started

    This plugin requires Grunt 0.4.0

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

    npm install grunt-libsass --save-dev

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

    grunt.loadNpmTasks('grunt-libsass');

    The "libsass" task

    Run this task with the grunt libsass command

    This plugin automates fast compilation of scss files using libsass via the node-sass module. It aims to make coexistence with and transition from the grunt-contrib-sass library as painless as possible.

    Please not that grunt-libsass is incomplete and only very lightly tested at this point.

    Sass compatibility

    As noted in the documentation for the node-sass module

    The libsass library is not currently at feature parity with the 3.2 Ruby Gem that most Sass users will use, and has little-to-no support for 3.3 syntax.

    In other words, you may find that there are scss files it cannot compile and if there are sass 3.3 features you simply must have then the afforementioned grunt-contrib-sass plugin would be a better choice.

    Options

    options.loadPath

    Type: [String] Default value: []

    An array of paths to search for files to @import

    options.sourcemap

    Type: [String] Default value false

    When set to true a sourcemap named <css-file-name>.map will be generated in the same location as the compiled css file.

    Usage Examples

    Compile a single file

    In this example, the default options are used to compile a sass file

    grunt.initConfig({
      libsass: {
          myTarget{
              src: 'src/my.scss'
              dest: 'dist/my.css',
          }
      }
    });

    Compile all files in a directory, with a loadPath set and sourcemaps enabled

    In this example, all the scss files in a directory will be compiled. Paths are set to search for files to @import

    grunt.initConfig({
      libsass: {
        options: {
          loadPath: ['my/load/path'],
          sourcemap: true
        },
        files: {[
            {
                expand: true,
                cwd: 'my/src/dir',
                src: ['**/*.scss'],
                dest: 'dist',
                ext: '.css'
            }
        ]},
      }
    });

    Contributing

    In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using Grunt.

    Release History

    0.1.0 Alpha release. Limited functionality.

    0.1.1 Better documentation

    0.1.2 Screwed up 0.1.1 ...

    0.2.0 Added sourcemap option

    Install

    npm i grunt-libsass

    DownloadsWeekly Downloads

    0

    Version

    0.2.1

    License

    none

    Last publish

    Collaborators

    • robotlovesyou