realtyhub/bootstrap-bundle

Symfony2 Bundle with helpful tools relating to Twitter Bootstrap

, _(*1)

Bootstrap Bundle

Symfony2 Bundle for Twitter Boostrap

At the moment, this bundle has one purpose. It will allow your allow LESS files in your application, to have access to the variables in Twitter Bootstrap's variables.less, _(*2)

Installation and configuration

Composer.json, _(*3)

``` json { ... "require": { "realtyhub/bootstrap-bundle": "dev-master" } }, <sub>(*4)</sub>

AppKernel.php

``` php
<?php

public function registerBundles()
{
    $bundles = array(
        // ...
        new FOS\UserBundle\FOSUserBundle(),
    );
}

config.yml, <sub>(*5)</sub>

``` yml realtyhub_bootstrap: variables_less_path: "/path/to/variables.less", <sub>(*6)</sub>

# Basic Usage

Inside a Twig file

{% stylesheets '@YourBundle/path/to/file.less' filter='bootstrap_variables your_prefered_less_filter' %}
    <link rel="stylesheet" href="{{ asset_url }}" />
{% endstylesheets %}

### Warning

You will need to make sure that you are not accidently running the less filter before the bootstrap_variables filter.
This usually occurs is you have something like this in your config.yml

``` yml
assetic:
    filters:
        less:
            node: /usr/bin/node
            node_paths: [/usr/lib/node_modules]
            apply_to: "\.less$"

This filter will run before the "inlined" bootstrap_variables filter and therefore the less will not have access the the variables and will more than likely not complie., <sub>(*7)</sub>

This is why the alternative usage is suggested., <sub>(*8)</sub>

Alternative Usage

config.yml, <sub>(*9)</sub>

``` yml assetic: filters: bootstrap_variables: resource: 'assetic.xml' #workaround for assetic to accept our filter. #see https://github.com/symfony/AsseticBundle/issues/50 apply_to: ".less$" less: #Adjust paths to your environment node: /usr/bin/node node_paths: [/usr/lib/node_modules] apply_to: ".less$", <sub>(*10)</sub>

now inside of Twig file, you wont need to specify the filters and can try something like

{% stylesheets '@YourBundle/path/to/file.less'  %}
    <link rel="stylesheet" href="{{ asset_url }}" />
{% endstylesheets %}

```, <sub>(*11)</sub>

TODO

• Better intergration with braincrafted bootstrap bundle. Is it possible to automattically determine the path to variables.less and remove the need for the configuration?