HUGO
Menu
GitHub 87548 stars Mastodon

Param

返回具有給定鍵的頁面參數,如果存在則回退到站點參數。

Syntax

PAGE.Param KEY

Returns

any

Page 對象上的 Param 方法在頁面參數中查找給定的 KEY,並返回相應的值。如果它不能在頁面參數中找到 KEY,它會在站點參數中查找 KEY。如果它在兩個位置都找不到 KEYParam 方法返回 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 }}

Last updated: January 1, 0001
Improve this page