【Hugo】--disableFastRenderでFast Render Modeを無効にする

Fast Render Modeとは

既定のhugo serverはFast Render Modeで動作する。起動ログにも表示される。

Running in Fast Render Mode. For full rebuilds on change: hugo server --disableFastRender

Fast Render Modeでは、コンテンツを1件編集して保存しても、サイト全体を再ビルドするのではなく、変更したページを中心に必要な範囲だけを再ビルドする。サイトの記事数が多いほど、この差は保存してからブラウザに反映されるまでの体感速度に効いてくる。

--disableFastRenderを付けると、この最適化を無効にし、変更のたびにサイト全体を再ビルドする。

使い方

$ hugo server --disableFastRender

起動ログから「Running in Fast Render Mode」の行が消える。

動作確認

1,316ページ(このブログ自体)を対象に、コンテンツを1件保存したときの再ビルド時間を比較した。

$ hugo server -M

Change detected, rebuilding site (#1).
Source changed /hugo/render-static-to-disk/index.md
Total in 16 ms

$ hugo server -M --disableFastRender

Change detected, rebuilding site (#1).
Source changed /hugo/render-static-to-disk/index.md
Total in 286 ms

同じ1件の変更に対して、既定のFast Render Modeでは16ms、--disableFastRenderでは286msだった。ページ数が多いサイトほど、この差は大きくなる。

反映漏れの切り分けに使う

Fast Render Modeは変更内容に応じて再ビルド範囲を絞り込むしくみのため、まれに編集内容を正しく反映できないことがあるとHugoのissueで報告されている。保存したはずの変更がブラウザに反映されない場合、--disableFastRenderを付けて起動し直せばサイト全体を常に再ビルドできるため、Fast Render Mode側の問題かどうかを切り分けられる。

参考: hugo server | Hugo