Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Jade and Jinja2 template support for Django (using PyJade's Jinja2 extension w/ Coffin)

branch: master

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 pyjade_coffin
Octocat-spinner-32 .gitignore
Octocat-spinner-32 AUTHORS
Octocat-spinner-32 CHANGES
Octocat-spinner-32 LICENSE
Octocat-spinner-32 MANIFEST.in
Octocat-spinner-32 README.rst
Octocat-spinner-32 requirements.txt
Octocat-spinner-32 setup.py
README.rst

pyjade-coffin

Jade and Jinja2 template support for Django using PyJade's Jinja2 extension with Coffin.

PyJade's Django template loader lacks mixin functionality due to the fact Django has no macro support. This package uses Coffin with PyJade's Jinja2 extension to overcome this. It also provides a few fixes/tweaks to make jade's behavior in Django more closely match the native JavaScript jade engine.

What this package does:

  • Registers PyJade's Jinja2 extension with coffin so .jade files are rendered though Jinja2 which gives us mixin support.
  • Add relative path include support by subclassing coffinEnvironment and overriding the join_path method. This matches jade's native JavaScript engine's behavior.
  • Sets Jinja2's autoescape to false which allows HTML escaping to be handled in Jade templates.

Installation

Install Package

Install with pip:

pip install pyjade-coffin

Setup Django

Add coffin and pyjade-coffin to INSTALLED_APPS in settings.py:

INSTALLED_APPS = (
...
    'coffin',
    'pyjade_coffin',
...
)

Usage

Shortcut Render Functions

To render a jade/jinja2 template you can use the render functions in the pyjade_coffin.shortcuts module provides:

  • render_to_response
  • render
  • render_to_string

These functions work just like django.shortcuts' render functions except they render Jade and Jinja2 templates.

NOTE: Jade templates are detected by their file extension so only *.jade files get processed by PyJade.

Here is an example view:

from django.template import RequestContext
from pyjade_coffin.shortcuts import render_to_response


def test_jade(request):
    c = RequestContext(request, {
        'test': ['this', 'is', 'test', 'data'],
        'check': "<em>Autoescape Test</em>",
    })

    return render_to_response('test_page.jade', c)
Something went wrong with that request. Please try again.