Skip to content
A CakePHP 1.3+ plugin for compiling Sass files to CSS
PHP
Find file
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
tests/cases/helpers
vendors/sass
views/helpers
LICENSE
README.md

README.md

Sassy Plugin for CakePHP 1.3+

This plugin monitors folders for Sass files and compiles them into CSS. It uses PHamlP to perform the compiling.

"Sass is a meta-language on top of CSS that’s used to describe the style of a document cleanly and structurally, with more power than flat CSS allows. Sass both provides a simpler, more elegant syntax for CSS and implements various features that are useful for creating manageable stylesheets."

Installation

  • Download the plugin

    $ cd /path/to/your/app/plugins && git clone git://github.com/joebeeson/sassy.git
    
  • Add the helper to your AppController

    public $helpers = array('Sassy.Monitor');
    

Configuration

  • Sassy.Recompile.Percentage - The chance percentage that each request has of invoking a check for updated files. Valid values are an integer between 0 and 100. This defaults to 10. If you want to handle the compiling manually through the recompile parameter, you should set this to 0.

  • Sassy.Recompile.Parameter - The named parameter to look for in the request that will force a recompile check. This defaults to sassy

  • Sassy.Recompile.Folders - An array of folders to monitor for Sass files. This defaults to app/webroot/css. By using an associative array you can tell the helper to save the compiled source to a different folder.

     Configure::write('Sassy.Recompile.Folders', array(
         '/look/for/sass/files/here' => '/then/save/the/css/file/here'
     );
    

Usage

Start making Sass files and make sure their extension is .sass -- that's it. The helper will periodically check for any files that need (re)compiling and handle everything for you.

Something went wrong with that request. Please try again.