orbis-labs/pug-symfony

Pug template engine for Symfony

Monday, July 3, 2017
by aecca
Repository
1 Watchers
0 Stars
66 Installations

PHP
0 Dependents
0 Suggesters
1 Forks
0 Open issues
21 Versions
0 % 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 orbis-labs/pug-symfony

Add in app/config/services.yml:, _(*4)

services:
    templating.engine.pug:
        class: PugBundle\PugTemplateEngine
        arguments: ["@kernel"]

Add jade in the templating.engines setting in app/config/config.yml:, _(*5)

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

Configure

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

$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, _(*7)

Usage

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

h1
  | Hello
  =name

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

/**
 * @Route("/contact")
 */
public function contactAction()
{
    return $this->render('contact/contact.html.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., _(*10)

In app/AppKernel.php, in the registerBundles() method, add the Pug bundle:, _(*11)

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

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, _(*12)

The Versions

03/07 2017

dev-master

9999999-dev

Pug template engine for Symfony

library pug-symfony

Pug template engine for Symfony

orbis-labs/pug-symfony

The README.md

Pug-Symfony

Install

Configure

Usage

Deployment

The Versions

dev-master

The Requires

The Development Requires

by Kyle Katarn

by Andy Ecca

2.2.3

The Requires

The Development Requires

by Kyle Katarn

by Andy Ecca

2.2.2

The Requires

The Development Requires

by Kyle Katarn

dev-fix-issue-11

The Requires

The Development Requires

by Kyle Katarn

dev-906c5a8

The Requires

The Development Requires

by Kyle Katarn

dev-css-helper

The Requires

The Development Requires

by Kyle Katarn

2.2.1

The Requires

The Development Requires

by Kyle Katarn

dev-analysis-8P33GA

The Requires

The Development Requires

by Kyle Katarn

2.2.0

The Requires

The Development Requires

by Kyle Katarn

2.1.5

The Requires

by Kyle Katarn

2.1.4

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