bobby / boot-sassc

Sass compiler task for boot 2

boot-sassc

Boot task to compile SCSS stylesheets with the sassc compiler.r

Notes:

• You must install the sassc compiler to use this library!
• The sassc executable only compiles SCSS syntax, not the indent-style Sass syntax!

Provides the sass task, which compiles SCSS to CSS.

Usage

Typically, you will have many SCSS files in your project, and one main SCSS file that @imports things in the correct order. Add your Sass source directory to your project's build.boot file:

;; in build.boot
(set-env!
  :dependencies '[...]
  :src-paths #{"sass/"})

Terminal

In a terminal you can compile all .sass and .scss files in your project with:

boot sass

To compile your main SCSS file only (so that @imports happen in the right order), use the -f flag:

boot sass -f sass/main.scss

To change the filename of the output stylesheet is output to, use the -o flag:

boot sass -o application.css

To regenerate the stylesheet on changes you can use boot's generic watch task:

boot watch sass

build.boot file in your project

In your build.boot you could call it like this:

(deftask run
  "Generate CSS from SCSS and watch for future changes"
  []
  (comp (watch) (sass)))

For examples of advanced settings in build.boot, refer to the example project.

Options

See the boot project for more information on how to use these. By default boot-sassc will save the compiled CSS file at target/main.css.

[f sass-file           str  "Input file. If not present, all .sass & .scss files will be compiled."
 o output-to PATH      str  "Output CSS file, path is relative to target/"
 t output-style TYPE   str  "Output style. Can be: nested, compressed."
 l line-numbers        bool "Emit comments showing original line numbers."
 g source-maps         bool "Emit source map."]

License

Copyright Matt Gauger 2014.

Distributed under the Eclipse Public License either version 1.0 or (at your option) any later version.