awakenweb/beverage-scss

Scss and Compass compiler module for Beverage task runner

beverage-scss

Scss and Compass compiler module for Beverage task runner, _(*1)

Prerequisites

• PHP 5.4+
• Composer

Install

Add this to your composer.json file:, _(*2)

{
    "require": {
        "awakenweb/beverage-scss": "dev-master"
    }
}

Configuration

In your drinkmenu.php file, add the following task:, _(*3)

<?php

use Awakenweb\Beverage\Beverage;
use Awakenweb\BeverageScss\Scss;

function defaultTask()
{
    scss();
}

function scss()
{
    Beverage::files('main.scss', ['scss'])
            ->then(new Scss('scss', Scss::USE_COMPASS, Scss::NESTED))
            ->destination('build/css');
}

Options

The Scss class accepts 3 parameters :, _(*4)

• importPath : tells the Scss compiler where to search for when it encounters an @include or @import directives., _(*5)

• useCompass : self-explanatory. True or False. You can use Scss::USE_COMPASS or Scss::NO_COMPASS for better maintenability., _(*6)

• formatter : choose from the 4 available formatters : Scss::NESTED, Scss::COMPRESSED, Scss::CRUNCHED, or Scss::NORMAL. (CRUNCHED is equivalent to COMPRESSED but also stripes CSS comments), _(*7)

Contributing

Bugs, _(*8)

• If you found a bug and feel confident enough to correct it, please send a pull request with your bugfix and a unit test to identify the bug., _(*9)

• If you can't correct the bug by yourself, please fill an issue on this Github repository., _(*10)

Security vulnerabilities, _(*11)

• If you think you found a security vulnerability in this package, please contact Mathieu SAVELLI by email before doing anything else.

New Features, _(*12)

• Before sending a Pull Request for a new feature you want to add directly to the Beverage codebase, please contact Mathieu SAVELLI by email. If the feature is found to be a good fit for Beverage, you are free to make a pull request., _(*13)

• If you like this package, the best thing you can do is to provide new awesome modules for Beverage and notify me. I'll add them to this readme., _(*14)

Contributors

• Main developer: __Mathieu SAVELLI__ (_mathieu.savelli@awakenweb.fr_)

License

Beverage and its official modules are released under the MIT License, _(*15)