LessElephantBundle

A Bundle to use the LessElephant library in a Symfony2 project., _(*1)

This bundle scans your less projects on every request, and checks if they needs to be recompiled. It takes care of dependencies, so you can use less with @import without problems. You don't need javascript or manual excution of lessc anymore, _(*2)

Installation, _(*3)

Integrate bootstrap in Symfony2 and compile less on the fly, _(*4)

Configuration

Add the configuration in your config file (for the dev environment), _(*5)

app/config_dev.yml, _(*6)

cypress_less_elephant:
    less_binary_path: "/usr/local/bin/lessc"
    less_projects:
        my-first-project:
            source_folder: %kernel.root_dir%/../src/Cypress/DemoBundle/Resources/public/bootstrap/less
            source_file: bootstrap.less
            destination_css: %kernel.root_dir%/../src/Cypress/DemoBundle/Resources/public/bootstrap/css/bootstrap.css
        another-project:
            .....
    force_compile: ~

less_binary_path (optional) is the path to your lessc binary. LessElephant try to find it with "which lessc". So, if you are on windows, you need this, _(*7)

less_projects (at least 1) define an entry for each of your less projects. All three parameters are mandatory, _(*8)

source_folder the folder where all your less files resides, _(*9)
source_file the main less file. Usually this is a file that contains many @import directive, _(*10)
destination_css the destination css. This file needs to be writable by web server user (for example on linux www-data), _(*11)

force_compile (optional) default: false. If it is true, we force the compilation for each request., _(*12)

Add the stylesheets to your templates, _(*13)

assetic, _(*14)

```html+jinja {% stylesheets filter="yui_css" "@CypressDemoBundle/Resources/public/bootstrap/css/bootstrap.css" %} {% endstylesheets %}, _(*15)


*without assetic*

```html+jinja
<link href="{{ asset('bundles/cypressdemo/bootstrap/css/bootstrap.css') }}" type="text/css" rel="stylesheet" />

Enjoy!, _(*16)

How it works

This bundle register an event listener that, on every request, check if the projects defined in the config_dev.yml files are in "clean" state or needs recompile., _(*17)

If the project do not need to be recompiled, it adds a really small overhead to symfony, just the time to check a bunch of files., _(*18)

Read the LessElephant readme for other useful informations, _(*19)