Pages

Page 对象上的 Pages 方法可用于这些页面类型：home、section、taxonomy 和 term。这些页面类型的模板会在上下文中接收一个页面集合，并按默认排序顺序排列。

在模板中遍历该页面集合：

{{ 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 子目录里的页面。该目录并不是一个 section——它不含 _index.md 文件。它的内容属于 lesson-2 这个 section。

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