The editor

Channels

A channel is a folder of posts. The Channels panel lists them, makes a new one from just a title, and keeps the rest tidy.

A channel is a folder of posts: a journal, notes, case studies, a changelog. List it in verso.json, and the editor gets a Channels panel for writing, finding and tidying its posts:

{
  "name": "Northlight",
  "channels": {
    "journal": { "label": "Journal", "template": "post", "item": "post" },
    "work/case-studies": { "label": "Case studies", "template": "case-study" }
  }
}
KeyWhat it does
The keyThe folder inside content/. A path works too, like work/case-studies
templateThe template every new post uses
labelWhat the panel calls the channel. Defaults to the folder's name
itemWhat one post is called, for buttons like “New post”. Defaults to “entry”

Making a channel in the editor

You don't have to write verso.json by hand. Open Channels and press Make a channel, or choose it in the command palette. Pick a folder that already holds pages, or A new folder…, then say what one item is called and which page type each new item uses. A new folder gets a page of its own, which already lists its items. Verso writes the channel into verso.json for you. A channel can be changed or stopped later; stopping one leaves its pages where they are.

The panel

Open Channels from its button in the bar, from the page menu on a phone, or from the command palette. With more than one channel, tabs along the top switch between them, each with its number of posts.

Posts are listed newest first, each with its title, date, address and whether it's a draft or live. The page you're on says “You're here”. Click a post to open it on the page, ready to edit.

The search box matches titles, addresses and descriptions. The All, Drafts and Live buttons narrow the list, and show how many of each there are.

Writing a new post

New post (or whatever your item is) asks for one thing: a title. The address is made from it as you type, so you can see where the post will live. The post is made with the channel's template, and its starting layout if it has one, dated today, as a draft, and opens ready to write. A title that's already taken gets -2 on its address.

Because it starts as a draft, nothing reaches the live site until you take it out of drafts and publish.

Tidying up

  • Duplicate copies a post's whole folder, images and all, as a draft named “… (copy)”, dated today.
  • Draft takes a post off the live site at the next publish, or puts it back. It's the same setting as in the site view.
  • Delete asks first. It removes the post's folder, and won't delete a post that has pages inside it. If the post was ever published, it's still in History. Deleting the page you're on takes you to the channel's own page.

Escape steps back one thing at a time: the delete question, then the new-post form, then the panel.

From the palette

Besides Make a channel, each channel adds two commands, named with its item and label: “New post in Journal” opens the panel with the new-post form ready, and “Open a post in Journal…” opens the panel on that channel.

Feeds and tags

Once verso.json has the site's "url", each channel also gets an RSS feed at /journal/feed.xml. See Feeds and sub-folders. Posts can be tagged in Page settings, and a channel's tags can have pages of their own.