什么是短代码
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 国际许可协议进行许可