Param
返回具有给定键的页面参数,如果存在则回退到站点参数。
Syntax
PAGE.Param KEY
Returns
any
Page 对象上的 Param 方法在页面参数中查找给定的 KEY,并返回相应的值。如果它不能在页面参数中找到 KEY,它会在站点参数中查找 KEY。如果它在两个位置都找不到 KEY,Param 方法返回 nil。
站点和主题开发者通常在站点级别设置参数,允许内容作者在页面级别覆盖这些参数。
例如,要在每个页面上显示目录,但允许作者根据需要隐藏目录:
配置:
params:
display_toc: true
[params]
display_toc = true
{
"params": {
"display_toc": true
}
}
内容:
---
date: '2023-01-01'
draft: false
params:
display_toc: false
title: Example
---+++
date = 2023-01-01
draft = false
title = 'Example'
[params]
display_toc = false
+++{
"date": "2023-01-01",
"draft": false,
"params": {
"display_toc": false
},
"title": "Example"
}
模板:
{{ if .Param "display_toc" }}
{{ .TableOfContents }}
{{ end }}Param 方法返回与给定 KEY 关联的值,无论该值是真值还是假值。如果您需要忽略假值,请改用以下结构:
{{ or .Params.foo site.Params.foo }}