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.