Jade

Jade works like any other template engine, taking a series of predefined tags and converting them to HTML code.

Jade is a great way to create page layouts, allowing dynamic content to be inserted without having to deal with pesky HTML tags every time.

The template engine can be used programmatically just like any other library or it can be used from Node.s console as well.

Besides the pure Node.js version, implementations for PHP, Ruby, Scala and client-side JavaScript are also available.

Features:

• No tag prefix
• Formatted output option
• HTML 5 mode (using the !!! 5 doctype)
• High performance parser
• Great readability
• Code is escaped by default for security
• Contextual error reporting at compile & run time
• Executable for compiling jade templates via the command line
• Optional memory caching
• Combine dynamic and static tag classes
• Parse tree manipulation via filters
• Supports Express JS out of the box
• Transparent iteration over objects, arrays, and even non-enumerables via - each

What is new in this release:

• Clean up path/fs functions in CLI as we no longer support node@0.6
• Update commander
• Document cache and parser options
• Fixed bug in 1.9.0 where we read the file if cache was enabled, even if a string was provided

What is new in version 1.8.0:

• Fix empty text-only block
• Warn about future change to ISO 8601 style dates
• Add warnings when data-attributes contain ampersands
• Allow custom pretty indentation
• Add support for an object in the style attribute
• Add support for an object in the class attribute

What is new in version 1.7.0:

• Added Doctype option on command line
• Support ES6 style rest args in mixins
• Fixed support for unicode newlines (\u2028, \u2029)
• Expose globals option from the with module
• Lots of new documentation

What is new in version 1.6.0:

• Allow optional white space after + when calling a mixin
• Use void-elements module to replace internal self-closing list
• Fix a warning that erroneously warned for unused blocks if in an extending template from an include
• Fix mixins not working at end of file
• Fix error reporting when mixin block was followed by blank lines

What is new in version 1.5.0:

• Added compileFile API.
• Fixed line number in unused blocks warning.
• Fixed a warning that erroneously warned for unused blocks if they were under another block.

What is new in version 1.4.0:

• Fixed an error that sometimes resulted in 'unexpected token "pipless-text"' being erroneously thrown.

What is new in version 1.3.1:

• Fixed error with tags in XML that are self-closing in HTML.
• Fixed error message for inline tags with content.

What is new in version 1.1.0:

• Throw an error when the same attribute is duplicated multiple times.
• Move more errors into the parser/lexer so they have more info about line numbers.

What is new in version 1.0.0:

• No longer support node@0.8
• Fix error reporting in layouts & includes
• Allow a list of 'globals' to be passed as an array at compile time & don't automatically expose all globals
• Escape apostrophes in data attributes
• Fix mixin/block interaction
• Ignore trailing space after mixin declaration
• Make literal . work as expected
• Remove implicit text only for script/style
• Stop parsing comments and remove support for conditional comments
• Make filtering includes explicit
• Remove special assignment syntax
• Remove !!! shortcut for doctype
• Remove 5 shorcut for html doctype
• Remove colons option from the distant past

What is new in version 0.35.0:

• Added support for space separated attributes.
• Added earlier errors for invalid JavaScript expressions.

What is new in version 0.34.1:

• Fixed render file not working when called with callback.

What is new in version 0.31.2:

• Fixed overzealous deprecation warnings.

What is new in version 0.29.0:

• Added "monocle" for watcher that actually works.
• Fixed interpolation in blocks of text.
• Fixed attribute interpolation.

What is new in version 0.27.7:

• Fixed each/else clause for enumerated objects.

What is new in version 0.27.6:

• Included templates can not override blocks of their parent.

What is new in version 0.26.2:

• Added --options alias of --obj.
• Added reserved word conflict prevention in Google's Closure Compiler.
• Added tag interpolation.

What is new in version 0.26.0:

• Added explicit self-closing tag support.
• Added block statement.
• Added mixin tag-like behavior.
• Fixed mixins with extends.

What is new in version 0.22.0:

• Added jade manpage (man jade after installation for docs)
• Added -D, --no-debug to jade(1)
• Added -p, --pretty to jade(1)
• Added -c, --client option to jade(1)
• Fixed -o { client: true } with stdin

What is new in version 0.21.0:

• Added new input/output test suite using Mocha's string diffing.
• Added alias extend -> extends.
• Fixed include escapes.
• Fixed block-expansion with .foo and #foo short-hands.

What is new in version 0.20.3:

• Changed: pass .filename to filters only.

What is new in version 0.20.0:

• Added a browser example.
• Added yield for block includes.
• Changed replaced internal __ var with __jade.
• Fixed two globals.

What is new in version 0.19.0:

• Added link in readme to jade-mode for Emacs.
• Added link to python implementation.

What is new in version 0.18.0:

• Changed:
• ['script', 'style'] are text-only.

What is new in version 0.17.0:

• jade.renderFile() is back! (for express 3.x).
• Fixed Object.keys() failover bug.

What is new in version 0.16.4:

• Fixed a test due to reserved keyword.
• Fixed: commander 0.1.x dep for 0.5.x.

What is new in version 0.16.1:

• Fixed unexpected else bug when compileDebug: false.
• Fixed attr state issue for balancing pairs.

What is new in version 0.15.2:

• Fixed new conditional boundaries.

What is new in version 0.14.0:

• Added array iteration with index example.
• Added runtime.js.
• Added compileDebug option to enable lineno instrumentation.
• Added inline option to disable inlining of helpers (for client-side).

What is new in version 0.13.0:

• Added mixin support.
• Added include support.
• Added array support for the class attribute.

What is new in version 0.12.4:

• Fixed filter indentation bug.

What is new in version 0.12.3:

• Fixed empty strings support.
• Fixed conditional comments documentation.

What is new in version 0.12.0:

• Added doctype as alias of !!!
• Added; doctype value is now case-insensitive.
• Added attribute interpolation support.
• Fixed; retain original indentation spaces in text blocks.

What is new in version 0.11.1:

• Fixed text block indentation.
• Changed; utilizing devDependencies.
• Fixed try/catch issue with renderFile().
• Removed attribute ":" support, use "=" (option for ':' coming soon).

What is new in version 0.11.0:

• Added self object to avoid poor with(){} performance.
• Added doctype option.

Requirements:

• Node.js