grunt-less-import-options

Import Less files using Less Import Options.

Getting Started

This plugin requires Grunt ~0.4.5

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-less-import-options --save-dev

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

grunt.loadNpmTasks('grunt-less-import-options');

The "less_import_options" task

Overview

In your project's Gruntfile, add a section named less_import_options to the data object passed into grunt.initConfig().

less_import_options: {
  options: {
    // Task-specific options go here.
  },
  your_target: {
    // Target-specific file lists and/or options go here.
  },
}

Options

For further documentation on the options see: http://lesscss.org/features/#import-options.

options.reference

Type: String | Array

options.inline

Type: String | Array

options.less

Type: String | Array

options.css

Type: String | Array

options.once

Type: String | Array

options.multiple

Type: String | Array

• As of 0.1.6, options may also be globbed -- file patterns beginning with ! will be ignored.

Usage Examples

Default Options

less_import_options: {
  files: {
    'dest/default_options': ['src/testing', 'src/123'],
  },
},

Custom Options

less_import_options: {
  options: {
    reference: ['file.less', 'otherfile.less'],
    inline: ['file.less', 'otherfile.less']
  },
  files: {
    dest: 'dest/styles.less'
  }
});

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.