建站踩坑记录

开始使用 Hugo 后的相关踩坑记录,包括主题和网站布署等方面的问题。

布署网站

两种 Shortcode 记号的差异

Hugo 的 Shortcode 可以使用 {{< >}}{{% %}} 两种记号。两者之间存在微妙的差异,有时可能引起问题。

参考:Hugo Discourse - .Destination from rel or relref does has unexpect prefix

在代码块中显示 Shortcode 原文

如果不使用特殊方法,代码块中的 Shortcode 也会被 Hugo 渲染成 HTML。

参考:How is the Hugo Doc site showing shortcodes in code blocks?

Markdown 中的反引号

如何在行内代码中输入一个或多个反引号 `?如何在代码块中显示 ```

关键是用不同数量的反引号包围之

Enter any child page of Series.