TheCloud/hugoDocs
1
0
Fork 0
mirror of https://github.com/gohugoio/hugoDocs.git synced 2025-09-14 21:35:13 -04:00
Code Issues Packages Projects Releases Wiki Activity

Update description of .Pages based on its new behavior in Hugo 0.57+

Browse Source 
Also document the new `.RegularPages` now available in all pages,
starting from Hugo v0.57.0.

Fixes https://github.com/gohugoio/hugoDocs/issues/890.
This commit is contained in:
Kaushal Modi 2019-08-16 09:26:26 -04:00
parent 795e2a24e3
commit f76edaab07
1 changed files with 30 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

37
content/en/readfiles/pages-vs-site-pages.md
View File

@ -1,9 +1,32 @@
| Variable | Current context | Pages included | * A _regular_ page is a "post" page or a "content" page.
|----------------------|-----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| * A _leaf bundle_ is a regular page.
| `.Site.Pages` | **any** page | ALL pages of the site: content, sections, taxonomies, etc. -- Superset of everything! | * A _list_ page can list _regular_ pages and other _list_ pages. Some
| `.Site.RegularPages` | **any** page | Only regular (content) pages -- Subset of `.Site.Pages` | examples are: homepage, section pages, _taxonomy term_ (`/tags/`) and
| `.Pages` | _List_ page | Regular pages under that _list_ page representing the homepage, section, taxonomy term (`/tags`) or taxonomy (`/tags/foo`) page -- Subset of `.Site.Pages` or `.Site.RegularPages`, depending on context. | _taxonomy_ (`/tags/foo/`) pages.
| `.Pages` | _Single_ page | empty slice | * 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.
Note Note
: In the **home** context (`index.html`), `.Pages` is the same as `.Site.RegularPages`. : From the scope of _regular_ pages, `.Pages` and
`.RegularPages` return an empty slice.