Post
返回给定菜单条目的 `post` 属性。
这一页解决什么问题
菜单文案之外,条目常常还要带一点装饰:外链后面跟一个「↗」、新功能后面挂个 NEW 徽标、emoji 图标表示分类。Hugo 为这种「链接后面的小玩意」留了 post 属性,Post 方法就是把它读出来(对应的前置装饰见 Pre)。
它返回 template.HTML 类型,但内容不会自动当 Markdown 处理——post 里写 :point_left: 这种 emoji 短代码,要自己接一个 markdownify 才会变成真正的符号。
什么时候用,什么时候别用
该用:
- 纯装饰文本:箭头、emoji、
NEW/HOT字样; - 想让装饰随菜单配置走(同一个模板、不同菜单配不同后缀)。
别用:
- 要输出结构化的东西(图标字体元素、带 class 的
<span>)→ 用Params挂数据,在模板里决定结构,别把 HTML 塞进配置字符串; - 要显示菜单文字 → 用
Name; - 想让每个条目都带同样的后缀 → 直接写在模板里,不必逐条配
post。
用法
在下面的项目配置中,我们启用了 emoji 短代码的渲染,并在每个菜单条目的前面(pre)和后面(post)各添加一个 emoji 短代码:
toml
enableEmoji = true
[[menus.emojidemo]]
name = 'About'
pageRef = '/about'
post = ':point_left:'
pre = ':point_right:'
weight = 10
[[menus.emojidemo]]
name = 'Contact'
pageRef = '/contact'
post = ':arrow_left:'
pre = ':arrow_right:'
weight = 20要渲染该菜单:
go-html-template
<ul>
{{ range .Site.Menus.emojidemo }}
<li>
{{ .Pre | markdownify }}
<a href="{{ .URL }}">{{ .Name }}</a>
{{ .Post | markdownify }}
</li>
{{ end }}
</ul>Hugo 渲染结果为(实测,range 留下的空行已省略):
html
<ul>
<li>
👉
<a href="/about/">About</a>
👈
</li>
<li>
➡️
<a href="/contact/">Contact</a>
⬅️
</li>
</ul>完整示例:加不加 markdownify 的差别
go-html-template
直接输出:{{ range site.Menus.emojidemo }}{{ .Post }}|{{ end }}
markdownify:{{ range site.Menus.emojidemo }}{{ .Post | markdownify }}|{{ end }}
原始值:{{ range site.Menus.emojidemo }}[{{ printf "%q" .Post }}]{{ end }}实测输出:
直接输出::point_left:|:arrow_left:|
markdownify:👈|⬅️|
原始值:[":point_left:"][":arrow_left:"]你应当看到什么:不加 markdownify 时,.Post 就是配置里那串字符(:point_left:),emoji 短代码不会展开;加了 markdownify 才渲染成符号。所以只要用了 emoji/短代码写法,就必须配 markdownify,同时项目配置里要有 enableEmoji = true。
返回值边界(实测)
测量条件:Hugo 0.167.0 extended,配置 enableEmoji = true,Windows。
| 情况 | 结果 | 是否报错 |
|---|---|---|
条目写了 post |
原样返回该字符串(实测 ":point_left:") |
否 |
条目没写 post |
空字符串(直接输出等于什么都没渲染) | 否 |
加了 markdownify 且 enableEmoji = true |
emoji 短代码被渲染成实体,例如 :point_left: → 👈 |
否 |
加了 markdownify 但没开 enableEmoji |
保持原样文本(emoji 短代码不生效) | 否 |
| 内容是普通文字 | 原样输出 | 否 |
| 返回类型 | template.HTML(因此直接输出时不会被转义成 HTML 实体) |
否 |
常见坑
| 类别 | 症状 | 真因 | 怎么修 |
|---|---|---|---|
| 没报错但结果不对 | 页面上真的显示出 :point_left: 字样 |
没接 markdownify,emoji 短代码不会自动展开 |
写成 {{ .Post | markdownify }} |
| 没报错但结果不对 | 加了 markdownify 也没变成 emoji |
项目配置没开 enableEmoji |
配置里加 enableEmoji = true |
| 没报错但结果不对 | 想加带 class 的图标却渲染不出结构 | 把 HTML 字符串塞进了 post |
改用 Params 存数据,模板里生成元素 |
更多排查入口见故障排查。