Param

Syntax

PAGE.Param KEY

Returns

any

Param 方法在 Page 对象上查找给定的 KEY，并返回对应的值。如果在页面参数中找不到 KEY，它会在站点参数中查找 KEY。如果在任何位置都找不到 KEY，Param 方法将返回 nil。

站点和主题开发者通常在站点级别设置参数，允许内容作者在页面级别上覆盖这些参数。

例如，要在每个页面上显示目录，但允许作者根据需要隐藏目录：

配置：

hugo.

params:
  display_toc: true

[params]
  display_toc = true

{
   "params": {
      "display_toc": true
   }
}

内容：

content/example.md

---
date: "2023-01-01"
display_toc: false
draft: false
title: Example
---

+++
date = 2023-01-01
display_toc = false
draft = false
title = 'Example'
+++

{
   "date": "2023-01-01",
   "display_toc": false,
   "draft": false,
   "title": "Example"
}

模板：

{{ if .Param "display_toc" }}
  {{ .TableOfContents }}
{{ end }}

Param 方法返回与给定 KEY 关联的值，无论该值是真值还是假值。如果你想忽略假值，可以使用以下结构：

{{ or .Params.foo site.Params.foo }}