Collections
Stacey provides collections of related pages and assets which can be looped over from within the templates.
- page.root
- Will list each top-level page within /content.
- page.children
- Will list any child pages relative to the current page.
- page.parents
- Will list the full ancestor tree relative to the current page.
- page.parent
- Will list the direct ancestor relative to the current page.
- page.siblings
- Will list any pages sitting at the same level as the current page. This collection does not include the current page.
- page.siblings_and_self
- Will list any pages sitting at the same level as the current page. This collection includes the current page.
- page.next_sibling
- Constructs a reference to the next page sitting at the same level as the current page (in reverse-numeric order).
- page.previous_sibling
- Constructs a reference to the previous page sitting at the same level as the current page (in reverse-numeric order).
Asset Collections
- page.images
page.video - Will output a list of all the images or video files associated with this page (ie. sitting in the same folder as the page’s .yml file). If there are no matching assets, these collections will be empty.
- page.html,
page.swf,
page.mp3,
page.pdf,
etc. - Additionally, Stacey will create a collection for any file type (other than .yml files) that it finds within the page’s folder.
Read more about asset types.