sbt-sass plugin for sbt(probably, didn't test) and Play Framework 2.3.x

Plugin based on play-sass

ver 0.1.9 [09 oct 2014]

fixed incremental compilation issue in Windows

ver 0.1.8 [08 oct 2014]

fixed #14 issue with broken incremental compilation
exception message shows full path to file
changed compilation log message

ver 0.1.7 [17 sep 2014]

added sbt-digest and sbt-rjs plugins to play-sass-example
fixed #12. removed --sourcemap parameter from sass command line. it prevents deprecation warning.
fixed #11. fixed problems with assets pipeline. many thanks to @huntc

Prerequisites

Sass compiler needs to be installed for plugin to work. This means that sass executable needs to be found in path. Sass can be installed by installing sass gem (minimal version 3.4.0).

gem install sass -v 3.4.0

You can verify that sass has been installed by following command:

sass -v

Also you should install (opitonal) compass if you want to use it

gem install compass

Installation

External GitHub repository (Recommended)

Add line to project/plugins.sbt

resolvers += Resolver.url("GitHub repository", url("http://shaggyyeti.github.io/releases"))(Resolver.ivyStylePatterns)

addSbtPlugin("default" % "sbt-sass" % "0.1.9")

Run activator

Compilation from sources

Clone from this repo

git clone https://github.com/ShaggyYeti/sbt-sass.git

Enter to folder with sbt-sass and run sbt
In sbt-console execute command publishLocal
Add line in your play project to project/plugins.sbt
```
addSbtPlugin("default" % "sbt-sass" % "0.1.9")
```
Run activator

Usage

*.sass and *.scss files in app/assets directories will be automatically compiled to *.css files
Files starting with _-character will be left out from compilation as per Play convention.
For example the result of compilation of app/assets/test.scss you can include by next line:

<link rel="stylesheet" media="screen" href="@routes.Assets.at("test.css")">

also, you can use sbt-sass with WebJars. For example, webjar of Foundation:

add next line to build.sbt

libraryDependencies ++= Seq(
  "org.webjars" %% "webjars-play" % "2.3.0",
  "org.webjars" % "foundation" % "5.3.0"
 )

then you can include in scss-file:

@import "lib/foundation/scss/foundation";

Use sass-globbing pluging, If you want to import whole directory in sass
- Install plugin gem install sass-globbing
- Add line to build.sbt: sassOptions in Assets ++= Seq("-r", "sass-globbing")
- Now you can import a tons of files @import "styles/*"; or folders @import "styles/**/*";
- Plugin url: https://github.com/chriseppstein/sass-globbing

Example of play-project in play-sass-example folder

Compass (optional)

If u want to use compass just add next line in build.sbt:

sassOptions in Assets ++= Seq("--compass", "-r", "compass")

Troubles and solutions

Cannot run program "sass": error=2, No such file or directory
- In linux: you should add path to sass command to environment variable $PATH
- Running from IntelliJ IDEA: your IDE doesn't read environment variables, you should set PATH to sass in IDE settings. Solutions and documentation: issue #6, Idea Help: path variables
/var/lib/gems/1.9.1/gems/sass-3.4.2/lib/sass/util.rb:670:in `realpath': No such file or directory
- ruby 1.9.1 + sass 3.4.2 may throw this error. Solution: uninstall sass and install sass 3.4.0

hyysguyang/sbt-sass