StoryShape 1.0 · User guide

Write

User guide Part 5 of 13

Write is where the words go. Draft one scene, two side by side, or a whole chapter or book as one continuous page, with the formatting, fonts and tools a manuscript needs.

The manuscript library

Open Write from the footer tabs, or press Ctrl+4. The project library on the left shows MANUSCRIPTS: your books and everything in them.

Write with the scene Down the Rabbit-Hole open on a US Letter page. The project library shows the book Alice's Adventures in Wonderland, its chapter 1. Down the Rabbit-Hole, and five scenes. Above the page is the writing tools bar with Paragraph, Manuscript font, Size, bold, italic, underline, clear formatting, Alignment and More tools. Below it is the utility bar with Appearance, Map, World, References, Add to World…, the scene's word count, Page view set to US Letter, and a Zoom slider at 100%.
A scene in page view. The writing tools are above the page; view controls are below it.
Typing in a scene, with the draft in Literata.

How a manuscript is organized

The three kinds of container behave differently when you export or publish:

To change a container’s kind, select it and choose Change role… in the inspector.

Add books, chapters and scenes

  1. Choose + at the top of the library, or right-click an item and choose Add.
  2. In Add to manuscript, choose the Item type: Book, Chapter or Scene. For a chapter, choose a Container type: Chapter, Part or Folder.
  3. Choose where it goes (Inside) and type a Title.
  4. Choose Add book, Add chapter, Add part, Add folder or Add scene.

Rename, reorder and move

If moving scenes would take their plot links out of the plot’s book, StoryShape asks before moving them.

The library also works from the keyboard: arrow keys move between rows, → and ← expand and collapse, Shift+arrow keys extend the selection, and Shift+F10 opens an item’s menu.

Include or leave out

Every book, chapter and scene has Include in manuscript in the inspector. Leaving a scene out keeps it in the library but takes it out of word totals, continuous drafts, read aloud and default exports. It’s ideal for alternate versions and deleted scenes.

The right-click menu

Right-click any manuscript item for: Add, Rename…, Move to…, Move earlier, Move later, Add to collection, Pin as writing reference, Read aloud… (Windows) and Move to Trash. Scenes also have Add scene to Revision list, Add to Revision list and open markup, Edit scene people / POV… and Duplicate scene…. With several scenes marked, Merge N selected scenes… combines them.

Write a scene

Choose a scene in the library. Its title and word count appear above the page. Just start typing; the scene saves itself about a second after you pause.

If you want to save or undo right away, the header shows Unsaved changes with Discard and Save scene.

Books and chapters

Select a book or chapter and choose how to see it:

In Continuous Draft, scene boundaries show as a blank line. Typing at a boundary adds to the end of the earlier scene, and deleting across a boundary removes text from each scene without merging them. To split or merge scenes, use the scene tools.

The writing tools

The bar above the page applies to the scene you’re editing.

The Edit menu has the same commands, plus Paragraph Style with every heading level.

Paragraph styles

A paragraph style is a saved set of formatting you can apply in one step, such as “Letter” or “Epigraph”.

  1. Choose Paragraph → Manage styles…, or Edit → Paragraph Style → Manage Styles….
  2. Choose New, and give the style a Name.
  3. For each property, choose Keep existing, Use default or a value:
    • Semantic style (Body or a heading level);
    • Bold, Italic, Underline;
    • Alignment and Manuscript font;
    • Font size · pt, Left indent · pt, Right indent · pt, First line · pt, Space before · pt, Space after · pt and Line spacing · ×.
  4. Choose Save style.

Apply a style from the Paragraph menu. Only the properties you chose change. Styles are saved with the project.

A style is a command, not a link. Editing a style later doesn’t restyle paragraphs you already applied it to. Apply it again to update them.

A negative First line value makes a hanging indent.

Spacing and indents

To change the layout of selected paragraphs without making a style, choose More tools → Spacing & indents…. Set Left indent, Right indent, First line, Space before, Space after (in points) and Line spacing, then choose Apply to paragraphs. These settings travel with the project and affect exports.

Manuscript fonts

The Manuscript font menu offers:

Trying fonts in Draft appearance: Libre Baskerville, Cormorant Garamond, Atkinson Hyperlegible, Courier Prime and Literata.

The included fonts are the same on every computer, and StoryShape includes them in PDF exports and the paperback. See the font library.

Manuscript fonts are part of your text. Draft appearance, below, changes only how the draft looks to you.

Page view or pageless

The Page view menu below the draft sets the paper you see while writing:

The Zoom slider (75% to 150%) magnifies the page; choose the percentage to go back to 100%.

Paper, margins and zoom are settings for your writing view on this computer. They don’t change your manuscript, unless you choose Use writing-view paper & margins when you export.

If a very long scene is too big for page view, StoryShape shows it as continuous text and suggests splitting it or using Pageless.

Draft appearance

Draft appearance is how the page looks to you while you write. It never changes your stored formatting or exported layout, so set it for comfort.

For quick changes, choose Appearance below the draft. Pick a preset (Studio, Book serif or Typewriter), set the View size, or tick Typewriter scrolling.

For everything, choose Appearance → Customize… or Workspace → Draft Appearance…:

  1. Under Start from, choose Studio, Book serif or Typewriter.
  2. Choose a Typeface: a preset, one of the included fonts, or a font installed on your computer.
  3. Set Text size (10–36), Line height (1.00–2.50), Paragraph spacing (0–24) and Column width (pageless view) (320–1200).
  4. Check the preview and choose Apply. Reset goes back to Studio.

To use a font installed on your computer, choose Show fonts on this computer… in the dialog. Your system may ask permission to list them. Draft appearance is saved on this computer, so a draft shown in an installed font looks different on a computer that doesn’t have it.

The font library

StoryShape includes 23 fonts, all under the SIL Open Font License. You can use them for drafting, paragraph styles, exports and Publish.

Group Fonts
Book serif EB Garamond, Literata, Lora, Crimson Pro, Libre Baskerville, Merriweather, Alegreya, Cormorant Garamond, Spectral, Libre Caslon Text, Gentium Book Plus
Display Playfair Display, Cinzel
Sans serif Inter, Atkinson Hyperlegible, Nunito Sans, Work Sans, IBM Plex Sans, Lexend
Typewriter Courier Prime, IBM Plex Mono, Cutive Mono, Special Elite

A few good starting points: EB Garamond or Literata for literary fiction, Atkinson Hyperlegible if you want letters that are easy to tell apart, Courier Prime for a traditional manuscript, and Cinzel or Playfair Display for titles.

Focus mode and typewriter scrolling

Focus mode clears the screen around your words. It hides the top bar, the library, the inspector, references and the footer, and fades the writing tools until you move the pointer over them.

A book or chapter shows its Scenes view in Focus mode. StoryShape remembers whether you were in Focus for each project.

Typewriter scrolling keeps the line you’re typing in the middle of the window, so your eyes stay in one place. Turn it on under Appearance → Typewriter scrolling, or choose Workspace → Typewriter Scrolling.

References

Keep something open beside your draft to read while you write: a scene from earlier in the book, a character’s World page, an idea or a Board note.

  1. Right-click an item anywhere and choose Pin as writing reference. Or choose References below the draft, then + to find and pin something.
  2. The REFERENCE pane opens beside the draft. Choose which Pinned reference to show.

References are read only. Open in workspace takes you to the original; Unpin removes it from the list. Drag the pane’s edge to resize it. You can pin books, chapters, scenes, World entries, ideas, boards, notes, plots and cards, attachments and map pins.

Open beside

Work in two scenes at once, for example to keep a scene’s opening in view while you write its echo.

  1. Open a scene.
  2. Choose another scene from ◫ Open beside above the draft.

Both scenes are editable, and each saves to its own original. Formatting and tools apply to the pane you last clicked in. To go back to one scene, choose the blank ◫ Open beside option.

World in this passage

While you write, the top of the inspector shows WORLD IN THIS PASSAGE: the World entries whose names or aliases appear in the paragraph at your cursor. Choose Open entry to pin that entry beside your draft, or Save mention to record this passage on the entry.

Add a passage to World

  1. Select some text.
  2. Press Ctrl+Shift+W, choose Add to World… below the draft, or right-click and choose Add selected text to World….
  3. Choose New entry (with a Name and Type) or Existing entry.
  4. Add Additional information and Tags if you like. Under More details, you can add a typed detail too.
  5. Choose Add to World.

The exact passage and its source are kept on the entry. More on the World page.

Find and replace

In the current text

Press Ctrl+F (or Edit → Find in Current Text…). Type in Find in current text; the bar shows “3 of 12”. Use ↑ and ↓, or Enter and Shift+Enter, to step through matches. Tick Match case if you need it. Choose Replace… to show Replace with, Replace and Replace all. Esc closes the bar.

Across the project

Press Ctrl+Shift+F (or Ctrl+H on Windows and Linux), or choose Edit → Find and Replace in Project….

  1. Type the Find literal text and what to Replace with. Leave it empty to remove the text.
  2. Choose where to Look in: Included manuscript, World entries, Ideas and notes, or All editable text. With more than one book, you can limit the manuscript to one Book.
  3. Tick Match case, Whole words, or Match equivalent Unicode spellings as needed.
  4. Choose Preview. Every match is listed in context, with the old text struck through and the new text beside it.
  5. Untick any you want to leave alone, or use Select all and Select none.
  6. Choose Replace N passages.

Nothing changes until you choose replace. Snapshots and captured World sources keep their original quotes.

Cuttings

Cuttings keeps prose you’ve cut but might want again. Cut text stays out of the manuscript and out of word counts.

To keep a passage:

  1. Select it in a scene.
  2. Choose Edit → Move Selection to Cuttings…, More tools → Move selection to Cuttings…, or right-click and choose Move selected text to Cuttings….
  3. Give it a Name and an optional note on why you kept it.
  4. Choose Move to Cuttings. The passage leaves the scene.

To reuse a cutting:

  1. Place the caret where it should go, or select text to replace.
  2. Choose Browse Cuttings…, then Browse and reuse.
  3. Find the cutting, then choose Reuse and match style or Reuse with formatting.

A cutting stays in Cuttings after you reuse it, so you can use it again.

Split, merge and duplicate scenes

Save a scene before splitting or merging it. Every change can be undone.

Scene people and point of view

Record who is in a scene, separately from whose names happen to appear in it.

  1. Right-click a scene and choose Edit scene people / POV…, or choose Edit scene people… in the inspector.
  2. Choose the Point of view character.
  3. For each person, choose Present or Discussed only, or leave them Unassigned. People are your World entries of type Person; tick Other World types to show everything.
  4. Choose Save scene people.

These declarations appear on each person’s World page and can be used in collections.

Spelling and writing preferences

Spelling is checked as you type, using dictionaries on your computer. Nothing is sent online.

Workspace → Writing Preferences & Spelling… (or More tools → Spelling & typing…) sets these for the project:

Choose Save preferences. Preferences only affect what you type from now on; they never rewrite existing text.

Read aloud

Hearing your words read back is a good way to catch clumsy sentences. In StoryShape 1.0, read aloud uses the Windows speech voices, so these commands appear only on Windows. (The iPad edition reads aloud too; see StoryShape for iPad.)

In Listen to your passage, choose a Windows voice and a Reading pace, then Start. Use Pause, Resume and Stop. StoryShape remembers your voice and pace.

Read aloud uses the voices installed in Windows and works offline. To add voices, open Windows Settings → Time & language → Speech. In StoryShape 1.0, read aloud is available on Windows only; the iPad app has its own read aloud.

Paste and copy

Word counts

You’ll see word counts in several places:

Help → How Words Are Counted… explains the rules, with live examples. The short version: included scenes count once; World entries, ideas, comments, snapshots, cuttings and Trash add no manuscript words. More on the progress page.