MainSections

網站設定範例:

hugo.
     
params:
  mainSections:
  - books
  - films
[params]
  mainSections = ['books', 'films']
{
   "params": {
      "mainSections": [
         "books",
         "films"
      ]
   }
}

範本:

{{ .Site.MainSections }} → [books films]

如果 params.mainSections 在網站設定中未定義,這個方法會回傳包含一個元素的切片──擁有最多頁面的頂層區塊。

以下是內容結構範例,其中「films」區塊擁有最多頁面:

content/
├── books/
│   ├── book-1.md
│   └── book-2.md
├── films/
│   ├── film-1.md
│   ├── film-2.md
│   └── film-3.md
└── _index.md

範本:

{{ .Site.MainSections }} → [films]

在創建主題時,您可以指示網站作者在其網站設定中設定 params.mainSections,而不是將區塊名稱硬編碼。

然後您的首頁範本可以像這樣:

{{ range where .Site.RegularPages "Section" "in" .Site.MainSections }}
  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
{{ end }}