{
  "name": "grunt-contrib-compass",
  "description": "Compile Sass to CSS using Compass",
  "version": "0.5.0",
  "homepage": "https://github.com/gruntjs/grunt-contrib-compass",
  "author": {
    "name": "Grunt Team",
    "url": "http://gruntjs.com/"
  },
  "repository": {
    "type": "git",
    "url": "git://github.com/gruntjs/grunt-contrib-compass.git"
  },
  "bugs": {
    "url": "https://github.com/gruntjs/grunt-contrib-compass/issues"
  },
  "licenses": [
    {
      "type": "MIT",
      "url": "https://github.com/gruntjs/grunt-contrib-compass/blob/master/LICENSE-MIT"
    }
  ],
  "main": "Gruntfile.js",
  "engines": {
    "node": ">=0.8.0"
  },
  "scripts": {
    "test": "grunt test"
  },
  "dependencies": {
    "tmp": "0.0.21",
    "dargs": "~0.1.0",
    "async": "~0.2.0"
  },
  "devDependencies": {
    "grunt-contrib-clean": "~0.5.0",
    "grunt-contrib-jshint": "~0.6.0",
    "grunt-contrib-nodeunit": "~0.2.0",
    "grunt-contrib-internal": "~0.4.2",
    "grunt": "~0.4.0"
  },
  "peerDependencies": {
    "grunt": "~0.4.0"
  },
  "keywords": [
    "gruntplugin",
    "compass",
    "scss",
    "sass",
    "css",
    "compile",
    "preprocessor",
    "style"
  ],
  "files": [
    "tasks/compass.js",
    "tasks/lib/compass.js"
  ],
  "readme": "# grunt-contrib-compass [![Build Status](https://travis-ci.org/gruntjs/grunt-contrib-compass.png?branch=master)](https://travis-ci.org/gruntjs/grunt-contrib-compass)\n\n> Compile Sass to CSS using Compass\n\n\n\n## Getting Started\nThis plugin requires Grunt `~0.4.0`\n\nIf you haven't used [Grunt](http://gruntjs.com/) before, be sure to check out the [Getting Started](http://gruntjs.com/getting-started) guide, as it explains how to create a [Gruntfile](http://gruntjs.com/sample-gruntfile) as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:\n\n```shell\nnpm install grunt-contrib-compass --save-dev\n```\n\nOnce the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:\n\n```js\ngrunt.loadNpmTasks('grunt-contrib-compass');\n```\n\n\n\n\n## Compass task\n_Run this task with the `grunt compass` command._\n\n[Compass](http://compass-style.org/) is an open-source authoring framework for the [Sass](http://sass-lang.com/) css preprocessor. It helps you build stylesheets faster with a huge library of Sass mixins and functions, advanced tools for spriting, and workflow improvements including file based Sass configuration and a simple pattern for building and using Compass extensions.\n\nThis task requires you to have [Ruby](http://www.ruby-lang.org/en/downloads/), [Sass](http://sass-lang.com/tutorial.html), and [Compass](http://compass-style.org/install/) >=0.12.2 installed. If you're on OS X or Linux you probably already have Ruby installed; test with `ruby -v` in your terminal. When you've confirmed you have Ruby installed, run `gem update --system && gem install compass` to install Compass and Sass.\n\nCompass operates on a folder level. Because of this you don't specify any src/dest, but instead define the `sassDir` and `cssDir` options.\n\n### Options\n\nCompass doesn't expose all of its [options][config] through the CLI, which this task makes use of. If you need an option not mentioned below you can either specify a path to a config.rb file in the `config` option or embed it directly into the `raw` option. Options defined in your Gruntfile will override those specified in your config.rb or `raw` property. `config` and `raw` are mutually exclusive.\n\n#### config\n\nType: `String`  \nDefault: same path as your Gruntfile\n\nSpecify the location of the Compass [configuration file][config] explicitly.\n\n#### raw\n\nType: `String`\n\nString form of the Compass [configuration file][config].\n\n#### basePath\n\nType: `String`\n\nThe the path Compass will run from. Defaults to the same path as your Gruntfile.\n\n###### banner\n\nType: `String`\n\nPrepend the specified string to the output file. Useful for licensing\ninformation. **Note:** This only works in combination with the `specify` option\nand can conflict with sourcemap generation.\n\n#### app\n\nType: `String`  \nDefault: `stand_alone`\n\nTell compass what kind of application it is integrating with. Can be `stand_alone` or `rails`.\n\n#### sassDir\n\nType: `String`\n\nThe source directory where you keep your Sass stylesheets.\n\n#### cssDir\n\nType: `String`\n\nThe target directory where you keep your CSS stylesheets.\n\n#### specify\n\nType: `String|Array`\n\nLets you specify which files you want to compile. Useful if you don't want to compile the whole folder. Globbing supported. Ignores filenames starting with underscore. Files must be in the directory you specified in `sassDir`.\n\n#### imagesDir\n\nType: `String`\n\nThe directory where you keep your images.\n\n#### javascriptsDir\n\nType: `String`\n\nThe directory where you keep your JavaScript files.\n\n#### fontsDir\n\nType: `String`\n\nThe directory where you keep your fonts.\n\n#### environment\n\nType: `String`  \nDefault: `development`\n\nUse sensible defaults for your current environment. Can be: `development` or `production`\n\n#### outputStyle\n\nType: `String`\n\nCSS output mode. Can be: `nested`, `expanded`, `compact`, `compressed`.\n\n#### relativeAssets\n\nType: `Boolean`\n\nMake Compass asset helpers generate relative urls to assets.\n\n#### noLineComments\n\nType: `Boolean`\n\nDisable line comments.\n\n#### httpPath\n\nType: `String`  \nDefault: `/`\n\nThe path to the project when running within the web server.\n\n#### cssPath\n\nType: `String`\n\nThe directory where the css stylesheets are kept. It is relative to the `projectPath`. Defaults to \"stylesheets\".\n\n#### httpStylesheetsPath\n\nType: `String`  \nDefault: `httpPath + \"/\" + cssDir`\n\nThe full http path to stylesheets on the web server.\n\n#### sassPath\n\nType: `String`  \nDefault: `sass`\n\nThe directory where the sass stylesheets are kept. It is relative to the `projectPath`.\n\n#### imagesPath\n\nType: `String`  \nDefault: `images`\n\nThe directory where the images are kept. It is relative to the projectPath.\n\n#### httpImagesPath\n\nType: `String`  \nDefault: `httpPath + \"/\" + imagesDir`\n\nThe full http path to images on the web server.\n\n#### generatedImagesDir\n\nType: `String`  \nDefault: value of `imagesDir`\n\nThe directory where generated images are kept. It is relative to the `projectPath`.\n\n#### generatedImagesPath\n\nType: `String`  \nDefault: value of `projectPath/generatedImagesDir`\n\nThe full path to where generated images are kept.\n\n#### httpGeneratedImagesPath\n\nType: `String`  \nDefault: `httpPath + \"/\" + generatedImagesDir`\n\nThe full http path to generated images on the web server.\n\n#### javascriptsPath\n\nType: `String`  \nDefault: `projectPath/javascriptsDir`\n\nThe full path to where javascripts are kept.\n\n#### httpJavascriptsPath\n\nType: `String`  \nDefault: `httpPath + \"/\" + javascriptsDir`\n\nThe full http path to javascripts on the web server.\n\n#### fontsPath\n\nType: `String`  \nDefault: `projectPath/fontsDir`\n\nThe full path to where font files are kept.\n\n#### httpFontsPath\n\nType: `String`\n\nThe full http path to font files on the web server.\n\n#### httpFontsDir\n\nType: `String`\n\nThe relative http path to font files on the web server.\n\n#### extensionsPath\n\nType: `String`  \nDefault: `project_root/extensions`\n\nThe full http path to the ad-hoc extensions folder on the web server. This is used to access compass plugins that have been installed directly to the project (e.g. through [Bower](https://github.com/bower/bower)) instead of globally as gems. *Only Compass >=0.12.2*\n\n#### extensionsDir\n\nType: `String`\n\nThe relative http path to the ad-hoc extensions folder on the web server. *Only Compass >=0.12.2*\n\n#### assetCacheBuster\n\nType: `Boolean`  \nDefault: `true`\n\nIf set to `false`, this disables the default asset cache buster.\n\n#### require\n\nType: `String|Array`\n\nRequire the given Ruby library before running commands. This is used to access Compass plugins without having a project configuration file.\n\n#### load\n\nType: `String|Array`\n\nLoad the framework or extensions found in the specified directory.\n\n#### loadAll\n\nType: `String|Array`\n\nLoad all the frameworks or extensions found in the specified directory.\n\n#### importPath\n\nType: `String|Array`\n\nMakes files under the specified folder findable by Sass's @import directive.\n\n#### debugInfo\n\nType: `Boolean`\n\nCauses the line number and file where a selector is defined to be emitted into the compiled CSS in a format that can be understood by the browser. Automatically disabled when using `outputStyle: 'compressed'`.\n\n#### quiet\n\nType: `Boolean`\n\nQuiet mode.\n\n#### trace\n\nType: `Boolean`\n\nShow a full stacktrace on error.\n\n#### force\n\nType: `Boolean`\n\nAllows Compass to overwrite existing files.\n\n#### dryRun\n\nType: `Boolean`\n\nDry Run. Tells you what it plans to do.\n\n#### boring\n\nType: `Boolean`\n\nTurn off colorized output.\n\n#### bundleExec\n\nType: `Boolean`\n\nRun `compass compile` with [bundle exec](http://gembundler.com/v1.3/man/bundle-exec.1.html): `bundle exec compass compile`.\n\n#### clean\n\nType: `Boolean`\n\nRemove generated files and the sass cache. Runs `compass clean` instead of `compass compile`.\n\n\n[config]: http://compass-style.org/help/tutorials/configuration-reference/\n\n### Usage Examples\n\n#### Example config\n\n```javascript\ngrunt.initConfig({\n  compass: {                  // Task\n    dist: {                   // Target\n      options: {              // Target options\n        sassDir: 'sass',\n        cssDir: 'css',\n        environment: 'production'\n      }\n    },\n    dev: {                    // Another target\n      options: {\n        sassDir: 'sass',\n        cssDir: 'css'\n      }\n    }\n  }\n});\n\ngrunt.loadNpmTasks('grunt-contrib-compass');\n\ngrunt.registerTask('default', ['jshint', 'compass']);\n```\n\n\n#### Example usage\n\n\n##### Use external config file\n\n```javascript\ngrunt.initConfig({\n  compass: {\n    dist: {\n      options: {\n        config: 'config/config.rb'\n      }\n    }\n  }\n});\n```\n\n##### Override setting in external config file\n\n```javascript\ngrunt.initConfig({\n  compass: {\n    dist: {\n      options: {\n        config: 'config/config.rb',  // css_dir = 'dev/css'\n        cssDir: 'dist/css'\n      }\n    }\n  }\n});\n```\n\n##### Use `raw` option\n\n```javascript\ngrunt.initConfig({\n  compass: {\n    dist: {\n      options: {\n        sassDir: 'sass',\n        cssDir: 'css',\n        raw: 'preferred_syntax = :sass\\n' // Use `raw` since it's not directly available\n      }\n    }\n  }\n});\n```\n\n\n## Release History\n\n * 2013-08-08   v0.5.0   Add `assetCacheBuster` option.\n * 2013-07-28   v0.4.1   Fix `banner` option with `.css.scss` files.\n * 2013-07-19   v0.4.0   Add `banner` option. Show compilation time.\n * 2013-06-24   v0.3.0   Add `extensionDir` and `extensionPath` options. *Requires Compass >=0.12.2*.\n * 2013-04-11   v0.2.0   Add `clean` option. Expose `raw` options as Grunt options. Fix detection of `Nothing to compile` situation.\n * 2013-02-27   v0.1.3   Fixes bundleExec.\n * 2013-02-17   v0.1.2   Ensure Gruntfile.js is included on npm.\n * 2013-02-15   v0.1.1   First official release for Grunt 0.4.0.\n * 2013-02-05   v0.1.1rc8   Added new options: basePath specify, debugInfo.\n * 2013-01-25   v0.1.1rc7   Updating grunt/gruntplugin dependencies to rc7. Changing in-development grunt/gruntplugin dependency versions from tilde version ranges to specific versions.\n * 2013-01-10   v0.1.1rc5   Updating to work with grunt v0.4.0rc5.\n * 2012-10-22   v0.1.0   Initial release\n\n---\n\nTask submitted by [Sindre Sorhus](http://github.com/sindresorhus)\n\n*This file was generated on Thu Aug 08 2013 20:44:21.*\n",
  "readmeFilename": "README.md",
  "_id": "grunt-contrib-compass@0.5.0",
  "dist": {
    "shasum": "c1434eee9e945d0f502fc97c9c647d9109699a42"
  },
  "_from": "grunt-contrib-compass@~0.5.0",
  "_resolved": "https://registry.npmjs.org/grunt-contrib-compass/-/grunt-contrib-compass-0.5.0.tgz"
}