Pages

Pages 方法在 Page 物件中對以下頁面類型可用:homesectiontaxonomyterm。這些頁面類型的模板會在上下文中接收一個頁面集合

在模板中遍歷頁面集合:

{{ range .Pages.ByTitle }}
  <h2><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2>
{{ end }}

考慮以下內容結構:

content/
├── lessons/
│   ├── lesson-1/
│   │   ├── _index.md
│   │   ├── part-1.md
│   │   └── part-2.md
│   ├── lesson-2/
│   │   ├── resources/
│   │   │   ├── task-list.md
│   │   │   └── worksheet.md
│   │   ├── _index.md
│   │   ├── part-1.md
│   │   └── part-2.md
│   ├── _index.md
│   ├── grading-policy.md
│   └── lesson-plan.md
├── _index.md
├── contact.md
└── legal.md

當渲染首頁時,Pages 方法返回:

contact.md
legal.md
lessons/_index.md

當渲染 lessons 頁面時,Pages 方法返回:

lessons/grading-policy.md
lessons/lesson-plan.md
lessons/lesson-1/_index.md
lessons/lesson-2/_index.md

當渲染 lesson-1 頁面時,Pages 方法返回:

lessons/lesson-1/part-1.md
lessons/lesson-1/part-2.md

當渲染 lesson-2 頁面時,Pages 方法返回:

lessons/lesson-2/part-1.md
lessons/lesson-2/part-2.md
lessons/lesson-2/resources/task-list.md
lessons/lesson-2/resources/worksheet.md

在最後一個示例中,集合包含了 resources 子目錄中的頁面。該目錄並不是區段—它不包含 _index.md 文件,但其內容是 lesson-2 區段的一部分。

{{ range .Site.Pages.ByTitle }}
  <h2><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2>
{{ end }}