1
0
Fork 0
hugo/docs/content/en/functions/fmt/Warnidf.md

1.0 KiB

title description categories keywords params aliases
fmt.Warnidf Log a suppressible WARNING from a template.
functions_and_methods
aliases returnType signatures
warnidf
string
fmt.Warnidf ID FORMAT [INPUT]
/functions/warnidf

{{< new-in 0.123.0 />}}

{{% include "/_common/functions/fmt/format-string.md" %}}

The warnidf function evaluates the format string, then prints the result to the WARNING log. Unlike the warnf function, you may suppress warnings logged by the warnidf function by adding the message ID to the ignoreLogs array in your site configuration.

This template code:

{{ warnidf "warning-42" "You should consider fixing this." }}

Produces this console log:

WARN You should consider fixing this.
You can suppress this warning by adding the following to your site configuration:
ignoreLogs = ['warning-42']

To suppress this message:

{{< code-toggle file=hugo >}} ignoreLogs = ["warning-42"] {{< /code-toggle >}}