jade Getting started with jade Syntax


Pug (old name is Jade) is a clean, whitespace sensitive syntax for writing HTML. Here is a simple example:

doctype html
    title= pageTitle
      if (foo) bar(1 + 5)
    h1 Pug - node template engine
      if youAreUsingPug
        p You are amazing
        p Get on it!
        Pug is a terse and simple templating language with a
        strong focus on performance and powerful features.

Produces following output as HTML

<!DOCTYPE html>
<html lang="en">
    <script type="text/javascript">
      if (foo) bar(1 + 5)
    <h1>Pug - node template engine</h1>
    <div id="container" class="col">
      <p>You are amazing</p>
      <p>Pug is a terse and simple templating language with a strong focus on performance and powerful features.</p>

Here are the rules to render Pug to HTML code:

  1. By indenting the text, the HTML tree will be build. indenting could be used with spaces or tabs. This could not be mixed!
  2. HTML tags are written without < and >. Attributes are places between round brackets.
  3. Comment could be made with // or <!-- -->. Comments with //- are not visible in the rendered HTML.
  4. With #{ } will an offered model generated: #{header} #{user.username}.
  5. The # (hashtag) without braces will a div element created with the text as ID. Example #myID will be rendered as <div id="myID"></div>.
  6. With a . (point) will a div generated with a class attribute. Example: .myClass will be rendered as <div class="myClass"></div>
  7. With (equality sign followed by a space), a variable will be retrieved. Exaple: h1= title
  8. A != (not equal to) retrieved a variable without escaping.
  9. A - (hyphen) allows you to write JavaScript. Example: - console.log("foo");
  10. Linking to an external file can as follow: script(src="/js/chat.js")
  11. Inline script could by using this script..
  12. A directive for adding the basic layout: extends ../layout.
  13. At layout.pug happens the inserting by using block content
  14. Use of partials could on two ways:
    1. by partial: != partial(template file name/options).
    2. By include: include ../includes/footer
  15. The inverse of include is extend. This allows from a page "html block parts" to send to a layout page for example: extend layout
  16. Concatenating happens with the + (plus) or # (hashtag) char. The plus is used at JavaScript code. The hashtag in HTML and renders the content: `p The name is: #{myName}