Site
返回 Site 对象。
这一页解决什么问题
.Site 从当前页面出发,拿到当前语言对应的站点对象。模板里几乎所有「站点级」信息都从这里取:Title、Params、Home、Menus、Pages、Language、Taxonomies 等。
在多语言站点里,.Site 是语言相关的:英文页面的 .Site.Title 是英文站标题,中文页面是中文站标题(实测)。要一次拿到所有语言,用 hugo.Sites(.Sites 已弃用)。
什么时候用,什么时候别用
该用:
- 取站点标题、站点参数、首页、菜单、语言、分类法;
- 在 partial/短代码里需要「这个页面属于哪个站点」的上下文。
别用:
- 只想取站点参数 → 用全局
site函数(site.Params.foo)更短,效果等价; - 想列出所有语言站点 → 用
hugo.Sites; - 想拿「当前页面」→ 点号本身就是页面,别绕
.Site.Home。
用法
参见 Site 方法。
go-html-template
{{ .Site.Title }}完整示例:取站点级信息
测试站配置(节选)与模板:
toml
title = 'MP 测试站'
[params]
author = 'MP Author'layouts/_default/single.htmlgo-html-template
<p>{{ .Site.Title }}</p>
<p>{{ .Site.Params.author }}</p>
<p>{{ .Site.Home.RelPermalink }}</p>
<p>{{ .Site.Language.Lang }}</p>实测(Hugo 0.167.0):
| 渲染的页面 | .Site.Title |
.Site.Params.author |
.Site.Home.Path |
.Site.Language.Lang |
|---|---|---|---|---|
/posts/post-2/(英文) |
MP EN |
MP Author |
/ |
en |
/tags/(taxonomy 页) |
MP EN |
MP Author |
/ |
en |
你应当看到什么:.Site.Title 取的是当前语言的标题(配置里 [languages.en] title = 'MP EN'),不是项目级的 title = 'MP 测试站';.Site.Home 是当前语言的首页,.Site.Language.Lang 说明当前语言。切换到中文页面时,.Site.Title 会变成 MP ZH。
返回值边界(实测)
| 情况 | 结果 | 是否报错 |
|---|---|---|
| 任意页面(含列表页) | 当前语言的 Site 对象 | 否 |
.Site.Title |
当前语言标题(实测 MP EN) |
否 |
.Site.Params.* |
站点参数(实测 MP Author) |
否 |
.Site.Home |
当前语言首页的 Page 对象(.Path 为 /) |
否 |
.Site.Language.Lang |
语言标识(实测 en) |
否 |
| 多语言 | 每个页面只看到自己语言的站点;要全部语言用 hugo.Sites |
否 |
| 返回类型 | page.siteWrapper(用法等同 Site 对象,见 Site 方法) |
否 |
更多排查入口见故障排查。