errorf と warnf

errorf または warnf はフォーマット文字列を評価し、その結果を ERROR または WARNING ログに出力します (ログがあふれないように、エラーメッセージごとに一度だけ出力されます)。

ERROR が発生すると、ビルドも失敗します (hugo コマンドは、 exit -1 を実行します)。

どちらの関数も空文字列を返すので、メッセージはコンソールにのみ出力されます。

{{ errorf "Failed to handle page %q" .Path }}

{{ warnf "You should update the shortcodes in %q" .Path }}

なお、 errorf、erroridf、warnf は、 fmt  パッケージのすべてのフォーマット動詞をサポートしていることに注意してください。

エラーを抑制する

場合によっては、ユーザーが ERROR を抑制してビルドを成功させることが理にかなっている場合があります。

これを行うには、 erroridf 関数を使用します。この関数は第 1 引数としてエラー ID を受け取ります。

{{ erroridf "my-custom-error" "You should consider fixing this." }}

上記のコードにより、以下のメッセージが生成されます。

ERROR 2021/06/07 17:47:38 You should consider fixing this.
If you feel that this should not be logged as an ERROR, you can ignore it by adding this to your site configuration:
ignoreErrors = ["my-custom-error"]