pages-vs-site-pages.md (1274B)
1 * A _regular_ page is a "post" page or a "content" page.
2 * A _leaf bundle_ is a regular page.
3 * A _list_ page can list _regular_ pages and other _list_ pages. Some
4 examples are: homepage, section pages, _taxonomy_ (`/tags/`) and
5 _term_ (`/tags/foo/`) pages.
6 * A _branch bundle_ is a _list_ page.
7
8 `.Site.Pages`
9 : Collection of **all** pages of the site: _regular_ pages,
10 sections, taxonomies, etc. -- Superset of everything!
11
12 `.Site.RegularPages`
13 : Collection of only _regular_ pages.
14
15 The above `.Site. ..` page collections can be accessed from any scope in
16 the templates.
17
18 Below variables return a collection of pages only from the scope of
19 the current _list_ page:
20
21 `.Pages`
22 : Collection of _regular_ pages and _only first-level_
23 section pages under the current _list_ page.
24
25 `.RegularPages`
26 : Collection of only _regular_ pages under the
27 current _list_ page. This **excludes** regular pages in nested sections/_list_ pages (those are subdirectories with an `_index.md` file.
28
29 `.RegularPagesRecursive`
30 : {{< new-in "0.68.0" >}} Collection of **all** _regular_ pages under a _list_ page. This **includes** regular pages in nested sections/_list_ pages.
31
32 Note
33 : From the scope of _regular_ pages, `.Pages` and
34 `.RegularPages` return an empty slice.