kylekatarnls/jade-symfony

Pug template engine for Symfony

Tuesday, October 10, 2017
by kylekatarn
Repository
1 Watchers
4 Stars
1,083 Installations

PHP
0 Dependents
0 Suggesters
0 Forks
0 Open issues
30 Versions
8 % Grown

The README.md

Pug-Symfony

, _(*1)

Pug template engine for Symfony, _(*2)

Install

In the root directory of your Symfony project, open a terminal and enter:, _(*3)

composer require pug-php/pug-symfony

When your are asked to install automatically needed settings, enter yes ; or if you prefer, follow the manual installation steps below., _(*4)

Manual alternative steps

Add pug in the templating.engines setting in app/config/config.yml by merging the following to your settings:, _(*5)

services:
    templating.engine.pug:
        class: Pug\PugSymfonyEngine
        arguments: ["@kernel"]

framework:
    templating:
        engines: ['pug', 'twig', 'php']

In order to use pug cli commands, you will also need to add Pug\PugSymfonyBundle\PugSymfonyBundle() to your AppKenel.php., _(*6)

Configure

You can set pug options by accessing the container (from controller or from the kernel) in Symfony., _(*7)

$services = $kernel->getContainer();
$pug = $services->get('templating.engine.pug');
$pug->setOptions(array(
  'pretty' => true,
  'pugjs' => true,
  // ...
));
// You can get the Pug engine to call any method available in pug-php
$pug->getEngine()->share('globalVar', 'foo');
$pug->getEngine()->addKeyword('customKeyword', $bar);

See the options in the pug-php README: https://github.com/pug-php/pug And methods directly available on the service: https://github.com/pug-php/pug-symfony/blob/master/src/Jade/JadeSymfonyEngine.php, _(*8)

Initial options can also be passed in parameters in your config.yml:, _(*9)

parameters:
    pug:
        expressionLanguage: php

Usage

Create jade views by creating files with .pug extension in app/Resources/views such as contact.pug with some Jade like this:, _(*10)

h1
  | Hello
  =name

Then call it in your controller:, _(*11)

/**
 * @Route("/contact")
 */
public function contactAction()
{
    return $this->render('contact/contact.pug', [
        'name' => 'Bob',
    ]);
}

Deployment

In production, you better have to pre-render all your templates to improve performances. To do that, you have to add Pug\PugSymfonyBundle\PugSymfonyBundle in your registered bundles., _(*12)

In app/AppKernel.php, in the registerBundles() method, add the Pug bundle (this has been done automatically if you installed pug-symfony 2.3 or above with automated script):, _(*13)

public function registerBundles()
{
    $bundles = [
        ...
        new Pug\PugSymfonyBundle\PugSymfonyBundle(),
    ];

This will make the assets:publish command available, now each time you deploy your app, enter the command below: php bin/console assets:publish --env=prod, _(*14)

The Versions

10/10 2017

dev-master

9999999-dev

Pug template engine for Symfony

library jade-symfony

Pug template engine for Symfony

kylekatarnls/jade-symfony

The README.md

Pug-Symfony

Install

Manual alternative steps

Configure

Usage

Deployment

The Versions

dev-master

The Requires

The Development Requires

by Kyle Katarn

2.4.0

The Requires

The Development Requires

by Kyle Katarn

dev-2.3.1-dev

The Requires

The Development Requires

by Kyle Katarn

2.3.1

The Requires

The Development Requires

by Kyle Katarn

2.3.x-dev

The Requires

The Development Requires

by Kyle Katarn

2.3.0

The Requires

The Development Requires

by Kyle Katarn

2.2.5

The Requires

The Development Requires

by Kyle Katarn

2.2.4

The Requires

The Development Requires

by Kyle Katarn

2.2.3

The Requires

The Development Requires

by Kyle Katarn

2.2.2

The Requires

The Development Requires

by Kyle Katarn

2.1.5

The Requires

by Kyle Katarn

2.1.3

The Requires

by Kyle Katarn

2.1.2

The Requires

by Kyle Katarn

2.1.1

The Requires

by Kyle Katarn

2.1.0

The Requires

by Kyle Katarn

2.0.1

The Requires

by Kyle Katarn

2.0.0

The Requires

by Kyle Katarn

1.3.3

The Requires

by Kyle Katarn

1.3.2

The Requires

by Kyle Katarn

1.3.1

The Requires