Skip to content

Releases: jasonsanjose/brackets-sass

Fix missing binaries for linux and windows broken in 2.0.2

10 Jul 18:27
Compare
Choose a tag to compare

Install, Update or Uninstall Problem?

When updating or removing this extension, you may see the following error message from Brackets:

Unable to remove one or more extensions: jasonsanjose.brackets-sass. Brackets will still reload.

If you see this error, please follow these instructions to manually uninstall the extension.

Problems during install are less likely. However, if you do have problems installing, download the zip file manually here then follow these instructions

Whats New

Features:

Bug Fixes:

  • Missing windows and linux binaries #138

Basics

By default, any .sass or .scss file (but not partials) will be compiled (with source maps) when a file is saved. So, if you have a file styles.scss, the compiler will output styles.css and styles.css.map in the same folder. The compiler will also recompile when partial files change (Note: this requires that the main input file was at least compiled once with source maps).

README

Copied from README.md.

Compiles .scss/.sass files when changed. Updates styles during Live Preview. Demo video: http://youtu.be/gYE7jybP_5Y.

Compiler Compatibility

By default, this extension uses libsass 3.2. The Ruby-based sass compiler is also supported, see sass.compiler preference. For details on compatibility with the latest Sass features and popular Sass frameworks, see the wiki.

Features

  • Compiles *.sass (indented syntax) and *.scss (main syntax) files when changed and when any partial (@import dependency) is changed
  • Generates source maps
  • Show SASS compiler errors
  • Update CSS in Brackets' Live Preview
  • Option to swap libsass for Ruby sass compiler implementation
  • Experimental Compass support

Future Plans

  • Selector highlighting

Preferences

sass.enabled

Type: Boolean
Default: true

Enable/Disable compilation for a file.

sass.compiler

Type: String
Default: libsass
Values: libsass, ruby

Choose which compiler to use. libsass is used by default and is bundled with the extension, no extra install is necessary. Use ruby if you need full compatilibity with 3.4 (learn more about libsass compatibility. Using the ruby options requires separate installation.

sass.compass

Type: Boolean
Default: false

EXPERIMENTAL Enable/Disable Compass for a file. Requires "sass.compiler": "ruby" and Compass installation. Some Compass features will require a config.rb file at your project root.

As of the 2.0.x release, Compass support is experimental. Compiler workflows in Brackets are supported, e.g.:

  • Compiling on save
  • Compiler errors
  • Compiling when a partial changes
  • Source map output

Note that Live Preview is NOT supported yet. See example project for usage.

sass.options

outputDir

Type: String
Default: <parent directory of input sass file>

A relative file path (relative to the input file) to output both the CSS file and the source map.

output

Type: String
Default: <input sass file name>.css

File name to use for the output CSS file.

includePaths

Type: Array<String>
Default: []

An array of paths to use when resolving @import declarations (a.k.a --load-path, see Sass documentation)

outputStyle

Type: String
Default: nested
Values: nested, compressed

Determines the output format of the final CSS style. ('expanded' and 'compact' are not currently supported by [libsass], but are planned in a future version.)

sourceComments

Type: Boolean
Default: false

true enables additional debugging information in the output file as CSS comments

sourceMap

Type: Boolean | String | undefined
Default: true (implies <input sass file name>.css.map)

Outputs a source map. When sourceMap === true, the values for outputDir and output are used as the target output location for the source map. When typeof sourceMap === "String", the value of sourceMap will be used as the writing location for the file.

Sample .brackets.json File

Reference: Sample project using Bourbon and .brackets.json preferences file.

/*
Resulting file tree will appear as follows:
+ bower_components/
|--- bourbon/app/assets/stylesheets/_bourbon.scss
+ css/
|--- app.css
|--- app.css.map
+ scss/
|--- app.scss
*/

/* REMOVE comments from json file before using this template */
{
    /* disable compiling other files that aren't the "main" file */
    "sass.enabled": false,
    "path": {
        "scss/app.scss": {
            "sass.enabled": true,
            "sass.options": {
                "outputDir": "../css/",
                "includePaths": [],
                "sourceComments": true,
                "outputStyle": "nested"
            }
        }
    }
}

Update to libsass 3.2.5

09 Jul 22:48
Compare
Choose a tag to compare

Features:

Bug Fixes:

  • Wrong paths in source maps using the sourceMap option #114

Update to libsass 3.1. Support for Ruby. Experimental Compass support.

05 Mar 21:23
Compare
Choose a tag to compare

Install, Update or Uninstall Problem?

When updating or removing this extension, you may see the following error message from Brackets:

Unable to remove one or more extensions: jasonsanjose.brackets-sass. Brackets will still reload.

If you see this error, please follow these instructions to manually uninstall the extension.

Problems during install are less likely. However, if you do have problems installing, download the zip file manually here then follow these instructions

Whats New

  • libsass 3.1
  • Ruby compiler support via sass.compiler preference (requires separate install)
  • Experimental Compass support via sass.compass preference (compile only, no live preview)
  • Lots of Windows-only bug fixes with source map paths
  • Even more bug fixes (see issues list)

Basics

By default, any .sass or .scss file (but not partials) will be compiled (with source maps) when a file is saved. So, if you have a file styles.scss, the compiler will output styles.css and styles.css.map in the same folder. The compiler will also recompile when partial files change (Note: this requires that the main input file was at least compiled once with source maps).

README

Copied from README.md.

Compiles .scss/.sass files when changed. Updates styles during Live Preview. Demo video: http://youtu.be/gYE7jybP_5Y.

Compiler Compatibility

By default, this extension uses libsass 3.1. The Ruby-based sass compiler is also supported, see sass.compiler preference. For details on compatibility with the latest Sass features and popular Sass frameworks, see the wiki.

Features

  • Compiles *.sass (indented syntax) and *.scss (main syntax) files when changed and when any partial (@import dependency) is changed
  • Generates source maps
  • Show SASS compiler errors
  • Update CSS in Brackets' Live Preview
  • Option to swap libsass for Ruby sass compiler implementation
  • Experimental Compass support

Future Plans

  • Selector highlighting

Preferences

sass.enabled

Type: Boolean
Default: true

Enable/Disable compilation for a file.

sass.compiler

Type: String
Default: libsass
Values: libsass, ruby

Choose which compiler to use. libsass is used by default and is bundled with the extension, no extra install is necessary. Use ruby if you need full compatilibity with 3.4 (learn more about libsass compatibility. Using the ruby options requires separate installation.

sass.compass

Type: Boolean
Default: false

EXPERIMENTAL Enable/Disable Compass for a file. Requires "sass.compiler": "ruby" and Compass installation. Some Compass features will require a config.rb file at your project root.

As of the 2.0.x release, Compass support is experimental. Compiler workflows in Brackets are supported, e.g.:

  • Compiling on save
  • Compiler errors
  • Compiling when a partial changes
  • Source map output

Note that Live Preview is NOT supported yet. See example project for usage.

sass.options

outputDir

Type: String
Default: <parent directory of input sass file>

A relative file path (relative to the input file) to output both the CSS file and the source map.

output

Type: String
Default: <input sass file name>.css

File name to use for the output CSS file.

includePaths

Type: Array<String>
Default: []

An array of paths to use when resolving @import declarations (a.k.a --load-path, see Sass documentation)

outputStyle

Type: String
Default: nested
Values: nested, compressed

Determines the output format of the final CSS style. ('expanded' and 'compact' are not currently supported by [libsass], but are planned in a future version.)

sourceComments

Type: Boolean
Default: false

true enables additional debugging information in the output file as CSS comments

sourceMap

Type: Boolean | String | undefined
Default: true (implies <input sass file name>.css.map)

Outputs a source map. When sourceMap === true, the values for outputDir and output are used as the target output location for the source map. When typeof sourceMap === "String", the value of sourceMap will be used as the writing location for the file.

Sample .brackets.json File

Reference: Sample project using Bourbon and .brackets.json preferences file.

/*
Resulting file tree will appear as follows:
+ bower_components/
|--- bourbon/app/assets/stylesheets/_bourbon.scss
+ css/
|--- app.css
|--- app.css.map
+ scss/
|--- app.scss
*/

/* REMOVE comments from json file before using this template */
{
    /* disable compiling other files that aren't the "main" file */
    "sass.enabled": false,
    "path": {
        "scss/app.scss": {
            "sass.enabled": true,
            "sass.options": {
                "outputDir": "../css/",
                "includePaths": [],
                "sourceComments": true,
                "outputStyle": "nested"
            }
        }
    }
}

node-sass 2.0.1, libsass 3.1, ruby (and experimental compass) support

04 Mar 23:43
Compare
Choose a tag to compare

Install Instructions

To manually install this dev build, follow these instructions.

Release Notes

New

Bug Fixes

  • Windows source map path issues when files span multiple drives
  • Live preview issues when updating partials #91
  • Lint errors partials will compile the correct input file (based on an existing source map) #87

Changes to .brackets.json settings

{
    {
       "sass.compiler": "libsass|ruby", // default: "libsass"
       "sass.compass": false // default: false, experimental compile-only support (no live preview). requires config.rb at project root
    },
    "path": {
        "path/to/my.scss": {
            "sass.options": {
                "sourceMap": true | "relative/path/from/input.css.map" // default: true
            }
        }
    }
}

Notes

See pull request #100.

node-sass 2.0.1, libsass 3.1, ruby (and experimental compass) support

02 Mar 19:00
Compare
Choose a tag to compare

Install Instructions

To manually install this dev build, follow these instructions.

Release Notes

New

Bug Fixes

  • Windows source map path issues when files span multiple drives
  • Live preview issues when updating partials #91

Changes to .brackets.json settings

{
    {
       "sass.compiler": "libsass|ruby", // default: "libsass"
       "sass.compass": false // default: false, experimental compile-only support (no live preview). requires config.rb at project root
    },
    "path": {
        "path/to/my.scss": {
            "sass.options": {
                "sourceMap": true | "relative/path/from/input.css.map" // default: true
            }
        }
    }
}

Notes

See pull request #100.

node-sass 2.0.1, libsass 3.1, ruby support

26 Feb 19:14
Compare
Choose a tag to compare

See #100

node-sass 1.1.4, libsass 3.0.1

05 Nov 18:41
Compare
Choose a tag to compare
Pre-release

Fixes include paths on windows

TODO rebuild libsass binaries on mac

node-sass 1.0.1, libsass 3.0

23 Oct 19:09
Compare
Choose a tag to compare
Pre-release
1.0.0-61

fix jshint error

0.4.4-beta includePaths fix

13 Oct 19:36
Compare
Choose a tag to compare
Pre-release

See #39

Beta 0.2.1-0

30 May 18:09
Compare
Choose a tag to compare
Beta 0.2.1-0 Pre-release
Pre-release

Re-compile CSS when SASS dependencies change (@import files)