1. Pug

完整的文档在 pugjs.org

Pug是一个高性能的模板引擎，深受 Haml 的影响，并为 Node.js 实现了浏览器 JavaScript。对于bug报告、特性请求和问题，请打开一个问题。讨论请加入聊天室。

你可以在这里试驾 Pug。

1.1. 重命名自 "Jade"

这个项目以前被称为“Jade”。然而，它已经向我们透露，“Jade”是一个注册商标，因此需要重命名。在维护人员之间进行了一些讨论之后，“Pug” 被选为这个项目的新名称。下一个主要版本将把“pug” 作为包名。

如果您的包或应用程序目前使用的是 jade，请不要担心:我们已经获得了继续使用这个包名的权限，尽管所有的新版本都将在 pug 下发布。

在重命名之前，我们已经开始研究一个不兼容的 Jade 2.0.0。我们这样做了，所以这个新的主要版本 bump 将与重命名为 Pug 一致。因此，从 Jade 升级到 Pug，将与升级任何其他带有主要版本的包的过程一样。目前，Pug 2.0.0 还处于测试阶段，我们已经弃用了一些语法差异。这些差异在 #2305 被记录下来。

Pug的网站和文档还在更新中，但是如果你是 Pug 的新手，你应该开始使用新的语法，并在 npm 上安装 Pug 包。

1.2. 安装

1.2.1. 包

via npm:

$ npm install pug

1.2.2. 命令行

在安装了最新版本的 Node.js 后，使用以下指令安装命令行接口：

$ npm install pug-cli -g

运行：

$ pug --help

1.3. 语法

Pug是一种干净的、空白敏感的语法，用于编写 html。这里有一个简单的例子:

doctype html
html(lang="en")
  head
    title= pageTitle
    script(type='text/javascript').
      if (foo) bar(1 + 5)
  body
    h1 Pug - node template engine
    #container.col
      if youAreUsingPug
        p You are amazing
      else
        p Get on it!
      p.
        Pug is a terse and simple templating language with a
        strong focus on performance and powerful features.

对应的 HTML：

<!DOCTYPE html>
<html lang="en">
  <head>
    <title>Pug</title>
    <script type="text/javascript">
      if (foo) bar(1 + 5)
    </script>
  </head>
  <body>
    <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>
    </div>
  </body>
</html>

1.4. API

完整的 API，请参见 API英文文档。。也可以查看 Pug API 中文文档。

var pug = require('pug');

// 编译
var fn = pug.compile('string of pug', options);
var html = fn(locals);

// 渲染
var html = pug.render('string of pug', merge(options, locals));

// 渲染文件
var html = pug.renderFile('filename.pug', merge(options, locals));