Page index and tree

What is the page tree? And index?

Bedrock is a static site generator that can generate a whole website. But it is mainly used for prototypes. In prototypes it is useful to see the pages contained in the prototype.

This is done by looking at the page tree. By default, the index file of a prototype also contains a listing of the pages which we call the page index.

Page tree

You are free to replace this by your preferred homepage content.

The page tree shows a listing of the different pages in your prototype. The page tree can be shown and hidden at any time using the shortcut Ctrl + M (or Ctrl + B on Windows).

The page tree remember its state across pages. If you collapsed a folder, it will remember your choice as you navigate through the prototype.

How to add a page

To add a page, simply create a new .pug file in the /content/templates folder. Here is a basic page content setup you can use that will always work, regardless of folders/paths:

extends /templates_layouts/master

block body
    // Your code here

Note that we are using the Pug templating language.

When you add the page, you will see it appearing in the page index, and in the page tree.

Nested page structures

You can nest .pug templates in folders. The structure will be reflected on the index page and in the page tree.

Working with page states

Imagine you have a page called sign-in.pug. When you add another template called sign-in--error.pug (note the double dash), it will show up as a page state. Page states show up at the bottom of the page tree.

This is useful for showing the different states a page can be in.