文档章节
全局函数
在任何模板里直接取页面或站点对象:page 与 site 两个全局函数。
开始之前,你需要
- 知道模板里的「上下文」
.是什么(不确定先读模板简介)。
读完之后你能
- 在上下文不是页面的地方(例如数据模板、
_partials里被单独调用)拿到页面或站点对象; - 分清
page全局函数与$/.的区别,知道什么时候必须用它; - 避免为拿到
site而层层传参。
这一组包含什么
| 函数 | 用途 |
|---|---|
page |
取当前页面对象,等价于模板里常用的 .(在 . 已经指向别的值时就很有用) |
site |
取站点对象,用于 site.Params、site.Home、site.Language 等 |
什么时候必须用它们
在普通页面模板里,. 就是页面对象,直接写 .Title 即可。但这两种场合拿不到:
- 局部模板被单独调用时,
.可能是你传进去的一个字符串或字典——要在这里访问站点设置,用site; range循环体内,.变成了当前元素——要在这里访问外层页面,用page(或先把页面存进变量)。
go-html-template
{{ range .Pages }}
{{/* 这里的 . 是当前页面 */}}
<a href="{{ .RelPermalink }}">{{ .Title }}</a>
{{/* 要访问站点标题: */}}
<span>{{ site.Title }}</span>
{{ end }}下方列出本站收录的本组全部函数。