HUGO
Menu
GitHub 87548 stars Mastodon

RegularPages

返回当前栏目内的常规页面集合。

Syntax

PAGE.RegularPages

Returns

page.Pages

Page 对象上的 RegularPages 方法可用于这些 页面类型homesectiontaxonomyterm。这些页面类型的模板在 上下文 中接收页面 集合,按 默认排序顺序

在模板中遍历页面集合:

{{ 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 栏目的一部分。

Site 对象一起使用时,RegularPages 方法递归返回站点内的所有常规页面。详见 详情

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

Last updated: January 1, 0001
Improve this page