lapalabs/skeleton-bundle

The HTML markup skeleton of base templates for Symfony Framework

SkeletonBundle

The HTML markup skeleton of base templates for Symfony Framework, _(*1)

, _(*2)

Install

Install bundle with Composer dependency manager first by running the command:, _(*3)

$ composer require "lapalabs/skeleton-bundle:dev-master", _(*4)

Composer will install the bundle to your project's vendor directory., _(*5)

Include

Including the bundle to your Symfony project is as easy as to do a few simple steps., _(*6)

1) Enable the bundle in application kernel for prod environment:, _(*7)

``` php <?php // app/AppKernel.php, <sub>(*8)</sub>

public function registerBundles() { $bundles = array( // other bundles... new LapaLabs\SkeletonBundle\LapaLabsSkeletonBundle(), ); }, <sub>(*9)</sub>

2) Register the bundle's routes for `dev` environment *(optional, if you want to see demo examples)*:

``` yaml
# app/config/routing_dev.yml
_lapalabs_skeleton_bundle:
    resource: "@LapaLabsSkeletonBundle/Controller/"
    type:     annotation
    prefix:   /_lapalabs/skeleton

Usage

The best practices is to create your own template, that extends skeleton one. For example, create your own layout.html.twig in AppBundle:, <sub>(*10)</sub>

``` jinja {# src/AppBundle/Resources/views/layout.html.twig #}, <sub>(*11)</sub>

{% extends 'LapaLabsSkeletonBundle:html5:layout.html.twig' %}, <sub>(*12)</sub>

{% block css %} {{ parent() }} {# if you want to include content of parent block #} {% endblock %}, <sub>(*13)</sub>

{% block js %} {% endblock %}, <sub>(*14)</sub>

And then you can extends it in other templates:

``` jinja
{# src/AppBundle/Resources/views/Post/show.html.twig #}

{% extends 'AppBundle::layout.html.twig' %}

{% block content_wrap %}


{{ entity.heading }}


    <p>{{ entity.description }}</p>
{% endblock %}

Congratulations!

You're ready to rock your templates to extends skeleton templates!, <sub>(*15)</sub>

More documentation: * Overriding Bundle Templates * [How to Use Bundle Inheritance to Override Parts of a Bundle][2], <sub>(*16)</sub>