The editor

Site view and drafts

The site view shows every page as a card in a tree. Drag to reorder or nest pages, and mark any page as a draft to keep it off the live site.

Open the site view with the tree button in the bar, or choose Site view from the page menu. Each page is a card with a small live preview, its name and its address. The page you're on is outlined. Click a card's name to go to that page. Press Escape to close the view.

Reordering

Drag a card between two others to move it there. Or use a card's up and down arrows. The order is saved as an "order" number in each page's page.json, and the tree follows it.

A template can list pages in this order with the order sort, which is how these docs build their sidebar:

{{ each:docs:order }}
  <a href="{{ item.url }}">{{ item.title }}</a>
{{ /each }}

Lists sorted by newest, oldest, a-z or z-a ignore the site view's order.

Moving a page inside another

Drag a card onto another card to put it inside that page. If dragging is awkward, use the card's Move into button and pick the new parent from a list.

Because a page's address is its folder, moving a page moves its folder. Its images and the pages inside it go along, and its address changes: moving /spring-menu/ into /journal/ makes it /journal/spring-menu/.

Verso then fixes the links:

  • Links in rich text, on every page, that pointed at the old address are rewritten to the new one.
  • Text fields holding the old address, like a button's link set in Page settings, are updated too.
  • Templates are code, so Verso doesn't change them. If a template links to the old address, the confirmation names the template so you can change it yourself.

The confirmation says how many links were updated. If you moved the page you're on, the editor follows it to its new address.

Drafts

Tick Draft on any card to keep that page out of the live site. A draft:

  • is left out of the build, so it has no address on the live site,
  • doesn't appear in any list of pages, the search index or the sitemap,
  • can still be opened and edited in the editor like any other page,
  • shows a Draft label beside its name in the bar, the site view and the command palette, so it's never forgotten.

Untick it, publish, and the page goes live. The home page can't be a draft, or the site would have no front page.

In page.json, a draft is one line:

{
  "template": "post",
  "title": "Spring menu",
  "draft": true,
  "fields": {}
}

Moves are changes like any other

Reordering, moving and drafting all change files, so they show up in the Publish count and go live when you publish. Until then, the live site keeps the old order and addresses.