Sapphire Dog LLC Plotwright: Story Bible

Templates and fields

What each kind of element records, and how to change it.

Templates in the sidebar lists the templates for this library. Open one to add, rename or remove fields and groups, and drag fields to reorder them or move them between groups.

  • Fields can hold text, numbers, dates, choices, links to other elements, pictures and more.
  • Names From lets a template name its elements from fields, as Character does with First Name and Last Name.
  • Changing a template changes every element made from it. Values you've filled in stay with their fields.
  • If you're missing one of the starter templates, such as Item or Term, add it from the Templates list's menu with Add Starter Template.

Changing fields from an element's page

You don't have to go to Templates to add a field.

  • Add Field…, at the end of each group of fields on an element's page, adds one while you're filling it in, such as Fears on a character. Give it a name, a kind, choices for a pick list, and the group it goes in. It's added to the template beside where you clicked, so every element made from that template has it too, empty until filled in. (Calculated fields are made in Templates.)
  • Right-click a field on the Mac, or touch and hold it on iPad and iPhone, for Edit Field… (its name, kind, detail level and choices) or Remove Field…. Groups have Edit Group… and Remove Group… the same way. What's been filled in for a removed field is kept, hidden, and Undo puts it back.
  • Arrange Fields, beside Add Field…, shows the fields as a list of names. Drag one by its handle to move it, or onto a group's name to put it at the end of that group, use the button at the end of a row to edit it, and choose Done when they're in order. The order is the template's, so every element made from it shows its fields that way; fields not shown at an element's detail level keep their places.

Fields in parts

A field's value can be in parts, for the odd character whose eyes are two colours or whose ancestry is mixed. Turn on Can Be in Parts in the field's settings, and give the parts labels, such as Left Eye, Right Eye, or leave them empty for as many parts as needed, with Add Another.

Use Parts says when:

  • When Needed: Split into Parts appears under the field on an element's page, and Join Parts turns it back into one value.
  • Always.
  • When "Heterochromia" Is Chosen, for a pick list: picking that option opens a picker for each eye with the field's other choices.

Most characters keep a single value. In the text and the story bible, parts read by their labels, such as "blue left eye and green right eye", or "Elvish and human", and Style Check takes any part's colour as theirs. For an ancestry made from the parents', see Family Tree.

A template for one book

Set Used In in a template to make it one book's. Inside that book, adding an element offers the book's templates, and a book's own Character is used there instead of the library's, so books in one library can differ.

The same guide is in Plotwright under How It Works. This copy is for version 0.44.