Sitepress pages are organized as a hierarchical tree. For example, given the site directory:
├── helpers ├── layouts └── pages └── books ├── js-for-newbs.html.haml ├── html-for-newbs.html.haml └── html-for-newbs ├── chapter-1.html.md ├── chapter-2.html.md └── chapter-3.html.haml
Its possible to navigate pages via:
site = Sitepress::Site.new(root_path: "/my/site") book = site.resources.get("books/html-for-newbs.html") book.parents # All parents nodes (books, root) book.siblings # All siblings book.parent # This would return nil since the `book` node doesn't have a page. book.children # Returns all of the chapters in `html-for-newbs` (chatper-1 .. chapter-3)
Traversing the site hierachy is very useful for building site navigation components.
What if you want to programmatically manipulate your resources? For example, maybe you want to set the layout for the
video. The Site's
manipulate function makes that possible:
site = Sitepress::Site.new(root_path: "/my/site") site.manipulate do |resource| resource.data["layout"] = "video" if resource.data["video_url"] =~ /youtube/ end
site.resources method is called the rules from
manipulate are applied.
If you want to add or remove resources from the manipulate method, just add the second
resources argument to the
site = Sitepress::Site.new(root_path: "/my/site") site.manipulate do |resource, root| root.flatten.remove resource if resource.data["private"] end
Next, read about working with Frontmatter page metadata.