Pug 3への移行 (Pug 2から)

Jadeから移行する場合は、まずPug 2への移行の記事に従ってください。この記事では、Pug 2からPug 3へのアップグレード方法について説明します。

新機能の完全なリストについては、リリースノートを参照してください。以下は、破壊的な変更に対処するための手順のみです。

minify付きのフィルター ¶

JavaScriptまたはCSSを出力するフィルターを、minifyオプションと一緒に使用していた場合は、追加の依存関係を含める必要があります。JavaScriptのminifyをサポートする場合は、jstransformer-uglify-jsをインストールする必要があり、CSSのminifyをサポートする場合は、jstransformer-clean-cssをインストールする必要があります。

readプラグインはBufferを返す必要があるようになりました ¶

readプラグインを使用してPugがファイルを読み取る方法をオーバーライドしており、新しいrenderBufferフィルターをサポートしたい場合は、Bufferを返す必要があります。

例：

//- old

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

//- new

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

Node.jsのサポート ¶

10.0.0より前のNodeバージョンに対するサポートを終了しました。Pugを使用しているすべてのプロジェクトをNode.js 12にアップグレードすることをお勧めしますが、2021年4月まで10をサポートします。

将来、Nodeバージョンのサポートを終了する場合がありますライフサイクルが終了したときメジャーバージョンを上げることなく。