迁移到 Pug v3 From PUG 2

Pug中文使用手册～api 迁移到 Pug v3

如果您要从 Jade 迁移，请先阅读迁移到 Pug 2 文章。本文介绍如何从 Pug 2 升级到 Pug 3。

有关新功能的完整列表，请参阅发行说明。以下仅是处理重大更改的说明。

使用minify进行过滤

如果您没有使用带有minify选项的过滤器，则可以忽略此更改。

如果您使用输出 JavaScript 或 CSS 的过滤器以及minify选项，则现在需要包含额外的依赖项。如果您想支持缩小 JavaScript，则必须安装jstransformer-uglify-js，如果您想支持缩小 CSS，则必须安装jstransformer-clean-css。

read插件现在应该返回Buffer

Note

如果您不使用插件，则可以忽略此更改。

如果您使用“read”插件来覆盖 pug 读取文件的方式，并且想要支持新的“renderBuffer”过滤器，则需要返回“Buffer”。

例如

pug

v2版

pug

pug.renderFile(filename, {
  plugins: [
    {
      read: (filename) => {
        // this returns a "string"
        return fs.readFileSync(filename, 'utf8');
      },
    }
  ]
})

Node.js 支持

我们放弃了对 10.0.0 之前版本的支持。我们建议将所有使用 pug 的项目升级到 node.js 12，但我们将支持 10 直到 2021 年 4 月。

将来，我们可能会放弃对 node 版本的支持当它们达到使用寿命时，而不会进行重大版本升级。