RegularPages
返回當前欄目內的常規頁面集合。
Syntax
PAGE.RegularPages
Returns
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 欄目的一部分。
與 Site 對象一起使用時,RegularPages 方法遞歸返回站點內的所有常規頁面。詳見 詳情。
{{ range .Site.RegularPages.ByTitle }}
<h2><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2>
{{ end }}