术语表

短代码(shortcode)

在标记中调用的模板,可接受任意数量的参数,用于插入视频、图片等元素。

难度
参考

开始之前,你需要

  • 在文档里遇到不认识的 Hugo 术语时查阅

读完之后你能

  • 能判断一段内容该用短代码还是直接写 Markdown,并知道构建因短代码失败时先检查什么

接着读:短代码

短代码(shortcode)是在标记中调用的 template,可接受任意数量的 arguments。它们可与任何 content format 一起使用,把视频、图片和社交媒体嵌入等元素插入内容。

参见:短代码

为什么重要

短代码是让正文作者在不写 HTML 的前提下插入视频、图片、代码块等元素的出口,改一处模板就能改全站的输出。调用本站不存在的短代码会让整个站点构建失败,报 template for shortcode ... not found;想在正文里展示短代码语法本身也必须转义,否则会触发同样的失败。

延伸阅读:短代码目录、短代码模板