hugo/docs/content/en/functions/errorf.md
2023-05-22 16:47:07 +02:00

1.4 KiB

title description categories menu keywords signature relatedfuncs
errorf and warnf Log ERROR or WARNING from the templates.
functions
docs
parent
functions
strings
log
error
errorf FORMAT INPUT
printf

errorf or warnf will evaluate a format string, then output the result to the ERROR or WARNING log (and only once per error message to avoid flooding the log).

Any ERROR will also cause the build to fail (the hugo command will exit -1).

Both functions return an empty string, so the messages are only printed to the console.

{{ errorf "Failed to handle page %q" .Path }}
{{ warnf "You should update the shortcodes in %q" .Path }}

Note that errorf, erroridf, and warnf support all the formatting verbs of the fmt package.

Suppress errors

Sometimes it may make sense to let the user suppress an ERROR and make the build succeed.

You can do this by using the erroridf function. This functions takes an error ID as the first argument.

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

This will produce:

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 config:
ignoreErrors = ["my-custom-error"]