Hugo使用技巧

2022-04-10

如何引用站内文章

下面的 \\去掉

{{< ref "blog/post.md" >}} => https://example.com/blog/post/
{{< ref "post.md#tldr" >}} => https://example.com/blog/post/#tldr:caffebad
{{< relref "post.md" >}} => /blog/post/
{{< relref "blog/post.md#tldr" >}} => /blog/post/#tldr:caffebad
{{< ref "#tldr" >}} => #tldr:badcaffe
{{< relref "#tldr" >}} => #tldr:badcaffe

新窗口打开链接

根据文档：https://gohugo.io/getting-started/configuration-markup#blackfriday

以前默认的markdown解析引擎是 blackfriday,现在换成了 GoldMark。但是没发现 GlodMark有配置 a标签 blank的属性，所以暂时用 blackfriday。

[markup]
defaultMarkdownHandler = 'blackfriday'
[markup.blackFriday]
hrefTargetBlank = true

会在命令行收到弃用的警告：

markup.defaultMarkdownHandler=blackfriday is deprecated and will be removed in a future release. See https://gohugo.io//content-management/formats/#list-of-content-formats

如何左对齐、右对齐内容

通过自定义shortcodes 来实现。参考文章：https://guanqr.com/tech/website/hugo-shortcodes-customization/

<!-- 文件位置：~/layouts/shortcodes/align.html -->
<div style="text-align:{{ index .Params 0 }}">{{ markdownify .Inner }}</div>

然后在文章里使用：

{{< align left >}}
内容
{{< /align >}}

如何阻止Hugo渲染Shortcodes

需要在 {{< 和 >}}之间加上注释 /* ... */

{{</* align left */>}}

Shortcodes如何引用其他文件？

有一些公共的东西写在一个文件里，其他文件都可以引用，使用 partial 命令。

{{ partial "header/site-header.html" . }}

这个路径从 layouts/partials 开头
最后那个 . 很重要

Hugo的日期格式

[params]
# Hugo的日期格式也是奇葩，必须是2006年1月2日3时4分5秒
date_format = "2006-01-02"

hugo