github/hugo
1
0
Fork 0
mirror of https://github.com/gohugoio/hugo.git synced 2024-11-14 20:37:55 -05:00
Code Issues Projects Releases Packages Wiki Activity
hugo/docs/content/en/readfiles/pages-vs-site-pages.md
Bjørn Erik Pedersen f04cc581e1
Merge commit '00c4484c7092181729f6f470805bc7d72e8ad17b'
2022-11-17 16:16:19 +01:00

1.2 KiB
Raw Blame History

  • A regular page is a "post" page or a "content" page.
    • A leaf bundle is a regular page.
  • A list page can list regular pages and other list pages. Some examples are: homepage, section pages, taxonomy (/tags/) and term (/tags/foo/) pages.
    • A branch bundle is a list page.
.Site.Pages
Collection of all pages of the site: regular pages, sections, taxonomies, etc. -- Superset of everything!
.Site.RegularPages
Collection of only regular pages.

The above .Site. .. page collections can be accessed from any scope in the templates.

Below variables return a collection of pages only from the scope of the current list page:

.Pages
Collection of regular pages and only first-level section pages under the current list page.
.RegularPages
Collection of only regular pages under the current list page. This excludes regular pages in nested sections/list pages (those are subdirectories with an _index.md file.
.RegularPagesRecursive
Collection of all regular pages under a list page. This includes regular pages in nested sections/list pages.
Note
From the scope of regular pages, .Pages and .RegularPages return an empty slice.