格式化输出函数 on Hugo 中文文档

fmt.Errorf

Fri, 02 Oct 2026 00:00:00 +0800

Go 的 fmt 包的文档描述了格式字符串的结构与内容。

errorf 函数对格式字符串求值，然后把结果输出到 ERROR 日志并使构建失败。

{{ errorf "The %q shortcode requires a src argument. See %s" .Name .Position }}

用 erroridf 函数可以按需抑制特定的错误。

Fri, 02 Oct 2026 00:00:00 +0800

Go 的 fmt 包的文档描述了格式字符串的结构与内容。

erroridf 函数对格式字符串求值，然后把结果输出到 ERROR 日志并使构建失败。与 errorf 函数不同，你可以把消息 ID 加入项目配置的 ignoreLogs 数组，从而抑制 erroridf 函数记录的错误。

Fri, 02 Oct 2026 00:00:00 +0800

{{ print "foo" }} → foo
{{ print "foo" "bar" }} → foobar
{{ print (slice 1 2 3) }} → [1 2 3]

Fri, 02 Oct 2026 00:00:00 +0800

Go 的 fmt 包的文档描述了格式字符串的结构与内容。

{{ $var := "world" }}
{{ printf "Hello %s." $var }} → Hello world.

{{ $pi := 3.14159265 }}
{{ printf "Pi is approximately %.2f." $pi }} → 3.14

把 printf 函数与 safe.HTMLAttr 函数一起使用：

{{ $desc := "Eat at Joe's" }}
<meta name="description" {{ printf "content=%q" $desc | safeHTMLAttr }}>

Hugo 会把它渲染为：

Fri, 02 Oct 2026 00:00:00 +0800

{{ println "foo" }} → foo\n
{{ println "foo" "bar" }} → foo bar\n

Fri, 02 Oct 2026 00:00:00 +0800

Go 的 fmt 包的文档描述了格式字符串的结构与内容。

warnf 函数对格式字符串求值，然后把结果输出到 WARNING 日志。Hugo 对每条唯一消息只输出一次，以免日志被重复警告淹没。

Fri, 02 Oct 2026 00:00:00 +0800

Go 的 fmt 包的文档描述了格式字符串的结构与内容。

warnidf 函数对格式字符串求值，然后把结果输出到 WARNING 日志。与 warnf 函数不同，你可以把消息 ID 加入项目配置的 ignoreLogs 数组，从而抑制 warnidf 函数记录的警告。