electrotiti/tlassets-bundle

Symfony assets management with Gulp

tlassets-bundle

, _(*1)

TlAssetsBundle is an alternative to Assetic, it build your assets using NodeJS, GULP and custom Twig tags on a Symfony2 project., _(*2)

WARNING: This bundle is under development, do not use on production., _(*3)

How it works ?

1:/ In your Twig template, use the tags "style" and "js" to give assets source path and optional filters, _(*4)

2:/ The parser, find all Twig template with these tags and create a JSON buffer file in cache that describe the location of source path, the destination filename and some others options, _(*5)

3:/ The compiler read the buffer files previously created and compile the final assets with GULP, _(*6)

The goal of these two steps (and not one step like assetic does), is to parse your Twig template only when your assets definition change, and compile your assets only when you modify the content of your assets file., _(*7)

Prerequisites

First you have to install in your environment this tools: * Node JS * NPM, _(*8)

Installation

Gulp and dependencies

In order to install Gulp and his dependencies, execute command this command :, _(*9)

php app/console tlassets:gulp:install

Tags Twig

Below an example of tags that you can use in your Twig, _(*10)

```` Twig {% style "@MyCustomBundle/Resources/public/less/" filter="less" %} {% endstyle %}, <sub>(*11)</sub>

{% js "@MyCustomBundle/Resources/public/js/" %}, <sub>(*12)</sub>

{% endjs %}, <sub>(*13)</sub>

## Install your assets:

php app/console assets:install, <sub>(*14)</sub>

_This command (from Symfony), copy your assets from the folder : "src/" to the folder : "web/bundles/"_

## Quick assets compilation

To compile quickly your assets you just have to do this:

php app/console assets:dump, <sub>(*15)</sub>

_This command do a tlassets:flush, a tlassets:parse and a tlassets:compile"_

## Generate your assets step by step

Alternatively (and it's why this bundle is different of Assetic), each task on assets construction can be do separately

### Flush previous compilation

php app/console tlassets:flush, <sub>(*16)</sub>

_This command remove cache and assets previously generated in order to have a clean environment_

### Parse Twig template

php app/console tlassets:parse, <sub>(*17)</sub>

_This command parse your Twig template and create a JSON file on the cache directory that will be used by GULP_

### Compile assets

php app/console tlassets:compile ```` This command retrieves all file buffer previously created with the parsing command and compile the final assets files, <sub>(*18)</sub>