Bjørn Erik Pedersen
4dd90050f1
710856e5aRelease 0.84.0362f4ea7breleaser: Add release notes to /docs for release of 0.84.06bb8800f7docs: Regenerate docs helper00a522e6adocs: Regenerate docshelperbc171954bMerge commit '92405e5b0adc5d8c3dfde88d6a8b67eb09169190'ef73ffc3bMisc config loading fixes0b4117f7fdocs: Regenerate docs helper9b9452b9cMerge commit '32ba623541d74ee0b7ae4efb1b8326dc49af28b8'9c4413dd9tpl/fmt: Add erroridf template funce1875742etpl/data: Misc header improvements, tests, allow multiple headers of same keye4560893cAdd math.Max and math.Min7dc282eafcommon/maps: Add Scratch.DeleteInMapb9cd77171docs: Update querify function description and examples git-subtree-dir: docs git-subtree-split:710856e5a6
1.4 KiB
title, description, date, publishdate, lastmod, categories, menu, keywords, signature, workson, hugoversion, relatedfuncs, deprecated
| title | description | date | publishdate | lastmod | categories | menu | keywords | signature | workson | hugoversion | relatedfuncs | deprecated | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| errorf and warnf | Log ERROR or WARNING from the templates. | 2017-09-30 | 2017-09-30 | 2017-09-30 |
|
|
|
|
|
false |
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 and warnf support all the formatting verbs of the fmt package.
Suppress errors
Some times 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 arument.
`` {{ 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"]