Story pages
by Monday, April 11, 2016

Every item in a chatlog is rendered onto its own story page. To get from the item to its story page, click on the eye icon in the title line over the item. 

You can change the style of rendering in several ways:

  1. Edit the template. 
  2. Edit the menu bar.
  3. In Settings, the Pages panel lets you configure the title, home page URL, copyright string, and other values that appear on the story pages.

Editing the template

Each site (or chatlog) has one template that all pages are rendered through.

You can change the structure of the page, include different script and CSS files, or add scripts and CSS directly in the template. You should know what you're doing, of course. 

When you edit the template, any pages that have already been rendered should be re-rendered. That's what the Re-publish all pages command in the Main menu is useful for.

Editing the menubar

You can edit the contents of the menubar on each of your story pages by choosing the Edit menubar command in the Main menu.

Each top level item in the outline is the title of a menu, and each first-level item is a link. To add a link click the Link button, and paste the link and click OK.

The first time you edit the menubar, you need to rebuild all the pages to use the newly created menubar. However, you only have to do this once. The menubar is read each time the page is loaded.

Using the outliner

The menubar and template editors are outliners. For information on how to use an outliner, see this doc on the Fargo website. 

Static or dynamic?

It may appear that pages generated by are dynamic, because the updates from the editing system flow through to the rendered pages in real time.

Even so the pages are static. That means you can copy the files to a static folder and turn off the server. Or you can use S3 to store the pages and they will still be viewable if your server goes offline. The design is meant to be resilient and future-safe.

However this means that if you change your template you have to re-render the pages for the changes to take effect.