summaryrefslogtreecommitdiffstats
path: root/docs/content/en/functions/fmt/Errorf.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/content/en/functions/fmt/Errorf.md')
-rw-r--r--docs/content/en/functions/fmt/Errorf.md33
1 files changed, 33 insertions, 0 deletions
diff --git a/docs/content/en/functions/fmt/Errorf.md b/docs/content/en/functions/fmt/Errorf.md
new file mode 100644
index 000000000..da9845073
--- /dev/null
+++ b/docs/content/en/functions/fmt/Errorf.md
@@ -0,0 +1,33 @@
+---
+title: fmt.Errorf
+linkTitle: errorf
+description: Log an ERROR from a template.
+categories: [functions]
+keywords: []
+menu:
+ docs:
+ parent: functions
+function:
+ aliases: [errorf]
+ returnType: string
+ signatures: ['fmt.Errorf FORMAT [INPUT]']
+relatedFunctions:
+ - fmt.Errorf
+ - fmt.Erroridf
+ - fmt.Warnf
+aliases: [/functions/errorf]
+---
+
+The documentation for [Go's fmt package] describes the structure and content of the format string.
+
+Like the [`printf`] function, the `errorf` function evaluates the format string. It then prints the result to the ERROR log and fails the build. Hugo prints each unique message once to avoid flooding the log with duplicate errors.
+
+```go-html-template
+{{ errorf "The %q shortcode requires a src parameter. See %s" .Name .Position }}
+```
+
+Use the [`erroridf`] function to allow optional suppression of specific errors.
+
+[`erroridf`]: /functions/fmt/erroridf
+[`printf`]: /functions/fmt/printf
+[Go's fmt package]: https://pkg.go.dev/fmt