RegularPages
语法
PAGE.RegularPages
返回值
page.Pages
Page
对象上的 RegularPages
方法可用于以下页面类型:home
、section
、taxonomy
和 term
。这些页面类型的模板会在上下文中接收页面集合。
在您的模板中遍历页面集合
{{ range .RegularPages.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
渲染首页时,RegularPages
方法返回
contact.md
legal.md
渲染 lessons 页面时,RegularPages
方法返回
lessons/grading-policy.md
lessons/lesson-plan.md
渲染 lesson-1 时,RegularPages
方法返回
lessons/lesson-1/part-1.md
lessons/lesson-1/part-2.md
渲染 lesson-2 时,RegularPages
方法返回
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.RegularPages.ByTitle }}
<h2><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2>
{{ end }}