什么是短代码

Hugo喜欢Markdown,因为它的内容格式简单明了,但是有些时候Markdown也会有不足之处。通常,在Markdown内容中,内容作者被迫添加原始的HTML代码(例如,视频的)。我们认为这与Markdown语法的简洁之美相矛盾。

Hugo创建了短代码来解决这些限制。

短代码是一个简单的片段,位于内容文件中,Hugo将使用预定义的模板来渲染它。

请注意,短代码在模板文件中不起作用。如果你需要在模板中提供类似短代码的功能,你很可能需要[局部模板][partials]

除了更干净的Markdown之外,短代码也可以随时更新以反映新的类、技术或标准。在网站生成时,Hugo的短代码将轻松合并您的更改。这样,您就避免了繁琐的搜索和替换操作。

shortcode短代码

内置shortcode

详细介绍请阅读中文文档,了解每个内置shortcode的参数信息。

自定义shortcode

shortcode的参数值安全

在短代码的参数中使用";“分号等一些字符被认为是不安全的,因此需要特殊处理,比如设置style样式:

{{< tip title=“shortcode” style=“background-color: red;” >}}

something

{{< /tip >}}

获取style参数值需要这样处理:

.Get "style" | safeCSS

否则,我们可能得到一些加密字符串:

style="zgotmplz"

最后,效果如下:

shortcode

something

原文作者: 根叔

原始链接: https://www.learnhard.cn/learn-hugo/hugo_shortcodes/

发表时间: 2024-01-15 14:42:48 +0800 CST

版权声明:本文采用知识共享署名-非商业性使用 4.0 国际许可协议进行许可