Storyist is a creative writing application for Mac OS X 10.9 Mavericks or later. Designed specifically for novelists and screenwriters, it provides:
Produces submission-ready manuscripts and scripts. Storyist comes with several project templates that provide style sheets for industry-standard formatting. You don’t have to set the margins, font, line spacing, or anything else; just start typing, and you can produce a submission-ready manuscript or script.
But if you want to change the format, you can. Like most creative writing applications, Storyist provides a full complement of word processing tools, including spelling and grammar checking. But unlike some of the competing packages, Storyist also provides a page layout view and support for headers, footers, and style sheets so there is no need to export your finished draft to another word processor for final formatting.
Provides a high-level view of your story. The storyboarding tools in Storyist allow you to sketch out a story using photographs and index cards and then refine it with customizable plot, character, and setting sheets. For writers who prefer a more traditional approach, Storyist provides an outliner for working with story elements in outline form.
Keeps all your writing organized and accessible. The Project view lets you see your story elements at a glance and allows you to create and arrange them. The search field lets you quickly find what you’re looking for anywhere in your project and return to your writing.
Designed with novelists and screenwriters in mind, Storyist includes a number of story development power tools:
The Storyboard. Sometimes you want to put a face to a name. Storyist lets you cast your novel or screenplay with images from your photo collection or from the web. You can also view, edit, and arrange your scenes and plot points using virtual index cards on a cork board. And Storyist automatically transfers your storyboard information to story sheets for in-depth development.
The Outliner. A flexible outlining tool lets you display and edit not only your section or scene summaries, but also your plot, character, and setting notes.
Customizable story sheets. Story sheets are editable forms tailored for novel writing and screenwriting. You use them to record information about various aspects of your story, such as a character’s age or a description of a setting. Storyist comes with story sheets for plot, character, setting, and section/scene. And story sheets are customizable, so you can capture the information you want to capture.
Project-wide search. As you develop your story, your page count grows, and so does your collection of notes about your story—plot, character, and setting notes. Wouldn’t it be nice to be able to quickly find what you’ve written when you need it? With Storyist, you can. The search field, visible at all times in the toolbar, helps you quickly find the information you are looking for.
Full-screen Editing. Want to remove the distractions and focus on your writing? The full-screen editing mode puts the whole screen at your disposal, turning your computer into a dedicated writing environment.
Wiki linking. Your notes become much more valuable when you can describe the relationships between them with links. Using a simple Wiki syntax, you can quickly create links to any item in your project, and even create the items themselves. And when you do, Storyist maintains your links for you. If you change the title of a notebook entry, the titles of any links to it update automatically. If you move a plot point to a new section, plot point links in your Section Sheets adjust accordingly.
Smart text. In screenplay mode, Storyist collects your scene introductions, locations, times, character names, and transitions as you type and auto-completes them for you when you need them.
Quick styles. Tab and Return key shortcuts make changing between standard novel or screenplay elements as simple as typing a key or two. And with key equivalents for all of the styles in your style sheet, you can focus on writing, not formatting.
Installing the Storyist application and license is quick and easy.
To install Storyist:
When you purchase Storyist at the Storyist online store, you receive a license code via email that allows you to continue to use Storyist past the trial period. When you purchase Storyist through one of our partners, you receive your license code in the box. To install your license code:
Storyist can use your Internet connection (when active) to check automatically for updated versions. Automatically updating your software is recommended for all users, because it allows you to keep current with the latest features.
To enable automatic update checking:
You have the option of sending your system information to Storyist Support when you check for updates. By sending your system information, you encourage better support for your system configuration in future releases. The information sent is anonymous and is not associated with your name or any other personal information. To see the type of information that is sent, click the Learn More button.
The Storyist main window consist of four parts:
A Storyist project can contain text files, story sheets, folders, images, and bookmarks. The Project View—located to the left of the main window—helps you organize and access these items quickly.
To hide the Project View, choose View > Hide Project View. To display it again, choose View > Show Project View.
The Main view, located to the right of the Project view, has two components:
The Main view can be split both horizontally and vertically so that you can see multiple project items at once. For more information on splitting views, please see the section titled “Splitting Views.”
Much like a web browser, the navigation bar lets you switch between recently viewed pages. It also controls whether the content of the view is displayed using the Text view, the Outline view, or the Storyboard view. ￼
The navigation bar contains the following buttons:
The Text view is where you’ll do most of your writing. It displays your text files and story sheets in text form. ￼
To view your story elements in the Text view, navigate to the element you want to view, and do one of the following:
For more information on the Text View, please see the chapter titled “Working with Text.”
The outline view provides traditional outlining tools that let you quickly capture your ideas and work with them at a high level. ￼
To view your story elements in the Outline view, navigate to the element you want to view, and do one of the following:
For more information on the Outline view, please see the chapter titled “Working with Outlines.”
The storyboard view gives you a high-level overview of your text files, folders, and story elements (characters, plot points, and settings) by displaying them as index cards or photographs on a corkboard or collage.
To view your story elements in the Storyboard view, do one of the following:
Headings and groups are shown as items on corkboard. ￼
Body text and individual story elements are shown in a collage. ￼
For more information on the Storyboard view, please see “Working with Storyboards.”
The Storyist toolbar provides buttons for setting up the Storyist window and a status bar that shows information about the current cursor selection. The default toolbar configuration is shown below. ￼
Starting from the left, these are the Toolbar icons:
When you create a new document, Storyist displays a dialog to allow you to choose a template for your project. ￼
The Workspaces window lets you create and quickly switch between snapshots of your project views and windows. To view the Workspaces window, choose Window > Workspaces > Manage Workspaces ￼
The Inspector view allows you to quickly view and edit settings and formatting information.
To open the Inspector view, do either one of the following:
Each type of project item has its own inspector. The project and text inspectors are shown below. ￼
The Versions window gives you a quick overview of the older versions of your project and allows you to:
To view the Versions Window, choose File > Show Previous Versions.
Note: The Versions Window is not available until you’ve saved your project. ￼
Versions are stored on your Mac, and if you’ve enabled Time Machine, on your backup drive.
You can use the Mac OS X Fonts window to change font attributes such as typeface, size, color, underlining, and strikethrough. To view the Fonts window, choose Format > Font > Show Fonts. ￼
You can use the Mac OS X Colors window to change text color. To view the Colors window, do one of the following:
The General Preferences Pane lets you specify which template to use for new documents.
The Text Editing Preferences pane lets you specify:
The Plugins Preferences pane lets you specify which format converters are used for specific file types (for example, RTF files) and which text tools appear in the Edit > Tools menu. ￼
The Appearance Preferences pane lets you customize the fonts, colors, and icons used in the application. ￼
Many of the Storyist menu commands described in this user’s guide can be performed from the keyboard. To see a list of the available shortcuts, open Storyist and choose Help > Storyist Help, and click on the Keyboard Shortcuts link.
Some menu commands are also available from shortcut menus. To bring up a Shortcut menu, right-click or control-click an object or some selected text.
A Storyist project contains your text files, story sheets, folders and images.
When you launch Storyist or create a new project using the File > New Project command, the template chooser appears, allowing you to select a document template. Project templates provide:
Storyist comes with several built-in templates that you can use as starting points for a new project: Novel, Screenplay, Stage Play, and Blank.
The Novel Template—This template provides a starting point for a novel manuscript and includes:
If you want to write a novel and aren’t sure which template to use, select the Novel template.
The Screenplay Template—This template provides a starting point for a feature-length screenplay, and can be modified for playwriting. It includes:
If you want to write a script or screenplay and aren’t sure which template to use, choose this one.
The Stage Play Template—This template provides a starting point for a stage play. It includes:
Blank—This template provides a starting point for a project of any type. It includes empty folders to hold text files and images. To add text files, story sheets, or additional folders to the project, click the Add button.
You might want to designate a particular template to be used every time you create a new document. To set a default template:
Storyist can import files written in other word processors if the files are stored in one of the following formats:
Note: While some word processors do not store their files natively in the above formats, most do allow you to export your file into them. Refer to the word processor’s manual for details.
To import a manuscript or script into a new project:
To import a file into an existing project:
Note: You can also import a file simply by dragging to the Project view (on the left of the window) or to a folder in the Main view.
Your manuscript (or script) and notes are available from the Project view located at the left of the main window. To view an item listed in the Project view, simply click it.
Much like a Web browser, Storyist remembers which pages you have viewed and in what order. You can navigate through them using any of these methods:
You can change text appearance and size using the Format > Font menu, the Fonts window, or the Inspector.
The Format > Font menu offers basic formatting commands like Bold, Italic, and Underline that control the font weight and style, as well as commands to make text bigger or smaller. Most commands in this menu are assigned shortcut keys and can be invoked from the keyboard.
The Fonts window offers more precise control over font family, typeface, and size selection. In addition, it offers controls for changing text color and adding underlining, strikethrough, and shadow.
To open the Fonts window, choose Format > Font > Show Fonts.
The typeface you select determines the font weight and style. For instance, selecting the Oblique typeface in the Helvetica family provides italicized Helvetica. Similarly, selecting the Bold Oblique typeface provides a Helvetica font that is both bold and italic.
The Inspector’s Format pane offers control over font family, typeface, size, and color selection.
To open the Format pane in the Inspector, choose View > Inspector > Format.
Note: In some parts of the user interface, text appearance and size is determined by the program and are instead controlled by the Appearance tab of the Preferences window. Examples include the summary field in story sheets, text in the Outline view, and text in index cards.
You can change the text alignment and spacing by using the Format > Text menu, or by using the Inspector.
The Format > Text menu offers the frequently used alignment commands Align Left, Center, Align Right, and Justify, as well as commands for copying Ruler settings. Like the Format > Font menu, most commands are assigned shortcut keys and can be invoked from the keyboard.
To change text alignment by using the Format menu:
To change text alignment using the Inspector:
You can edit tab stops using the Ruler or the Inspector. To edit tab stops using the Ruler:
To edit tab stops using the Inspector:
To change existing tab stops, double-click the desired stop and enter a new value.
To add additional tab stops, click the Add button (+), double-click the new stop, and enter the desired value.
You can choose the type of the tab stop (left, center, right, or decimal) by selecting the corresponding value in the Alignment column.
You can also set a default tab interval. Tabs after the last tab specified in “Tab Stops” are placed this distance from the previous tab.
A value of zero causes tabs after the last tab specified in “Tab Stops” to move to the next line.
Note: By default, Storyist uses the first-line indent formatting property to indent paragraphs automatically and uses the Tab key to change styles. If you would like to use the Tab key to manually indent paragraphs:
The Margins section of the Format pane of the Inspector allows you to set page margins and specify that page margins be mirrored (used when laying out facing pages of a book to be printed).
To set page margins:
Note: You can enter margin values in inches, centimeters, points, or picas, using the abbreviations “in,” “cm,” “pt,” or “pc.”
When you specify Mirror Pages, Storyist lays out the pages so that the first (odd) page is on the right, as it is in a bound book. To specify mirrored pages:
Editing headers and footers is as simple as placing the cursor in the header or footer area and typing your text.
To edit the text of a header or footer:
All standard formatting features—including styles—are available in headers and footers.
To insert page numbers in your headers or footers:
Note: If you type a number in the header instead of inserting an auto incrementing page number field as described above, that number will appear in the header or footer on all pages.
You can change the location of the headers and footers from the Headers & Footers section of the Format pane of the Inspector.
To specify that adjacent pages have different headers and/or footers:
To adjust header or footer spacing:
Once you become comfortable with the menu commands, you might want to use keyboard shortcuts for some commands instead. A full listing of keyboard shortcuts can be displayed in a Help Viewer window. To see them, choose Help > Storyist Help, and click the Keyboard Shortcuts link.
A style is a collection of character and text formatting settings. Each Storyist template provides a group of styles, called a style sheet, which can be used to format your document quickly and consistently.
Note: Storyist provides support for what are commonly known as paragraph styles; that is, styles that apply to an entire paragraph.
There are several ways to change the style of text. First, select the text you want to change. Then, do one of the following:
There are two ways to create a new style. To use the first method:
To use the second method:
There are two ways to delete a style. To use the first method:
To use the second method for deleting a style:
To rename a style:
To modify a style:
A dialog appears, allowing you to edit the following properties: Style, Font, Spacing, Tabs, and Pagination.
Style Name—The name of the style.
Based on—The parent style of the style. Styles inherit the formatting properties of their parents.
Next Style—The style applied to a paragraph that is created when you press the Return key at the end of a paragraph.
Outline Level—The outline or heading level for the style. This value controls the outline level in the project view and in the outline view.
Tab Style—The style that is applied when you press the Tab key at the start of an empty paragraph.
Family—The general name given to a collection of related fonts (that is, the font family). Examples of family names include Courier, Times New Roman, and Arial.
Typeface—The name given to a specific font, which together with the family name specifies a font. Example typefaces include Regular, Bold, and Oblique.
Size—The point size of the font.
Color—The text or foreground color of the font.
Underline—The underlining setting for the font. Available values are None, Single, and Double.
Transform—The text transform for the text with this style. Available values are:
The spacing properties define the alignment, indentation, and space between paragraphs.
Text Alignment—Controls whether paragraph text is displayed left aligned, centered, right aligned, or justified.
Left Indent—Sets the text indentation from the left margin of all lines of a paragraph except the first line.
Right Indent—Sets the text indentation from the right margin. Note that positive values indicate offsets from the left margin, while negative values indicate offsets from the right margin.
First Line Indent—Sets the text indentation of the first line of a paragraph from the left margin.
Before Paragraph—Sets the space before the paragraph.
After Paragraph—Sets the space after the paragraph.
Line Spacing—Controls the amount of space between lines in a paragraph. Available values are:
Note: The spacing values display in the default measurement units for your Mac. You can change the default measurement units from the System Preferences window.
Default—Sets the default tab interval. Tabs after the last tab specified in “Tab Stops” are placed this distance from the previous tab.
Note—A value of zero causes tabs after the last tab specified in “Tab Stops” to move to the next line.
Stops—Defines the position and type of the tab stops. Tab types are:
The pagination properties define how text is laid out on the page.
Paginate As—Specifies the “pagination mode” of the style. Values other than Normal are used only in screenplay formatting and override the other pagination options.
Paragraph starts on a new page—A page break occurs before paragraphs having this style.
Keep with next paragraph—A paragraph displays on the same page as the paragraph that follows it. This option is useful for headings.
Avoid widow and orphan lines—Paragraphs that have a single line at the top of a page (a widow) or the bottom of a page (an orphan) move to the next page.
Storyist can import styles from other Storyist documents or from RTF files that include styles.
To import styles from another document:
Note that while many RTF files contain styles, some (those created by TextEdit, for example) do not.
One of the most helpful features that Storyist provides is the ability to create links. You can link from your Storyist project to locations on the Web so you can have quick access to external information, or you can create links within your project to connect internal elements to each other.
To create an internal link:
To create an external link (to a Web page):
You can also create a link from the keyboard using a simplified Wiki link syntax:
To edit a link using the menu:
To edit a link using the context menu:
To edit the title of a link using the keyboard:
To remove a link (without deleting the underlying text):
You can add new elements (chapters, sections, or scenes) to your text at any time. These new additions automatically generate new index cards in the storyboard and new entries in the outline.
To add an outline element to the text:
See the section titled “Creating and Applying Styles” for more information on styles.
As you are writing, you might want to make notes (comments) on specific paragraphs or sentences for later revision.
To add a comment to a text location:
To close the comment window, press the Escape (esc) key or click in an area outside the comment window.
A comment icon appears to indicate that a comment is attached to the current location.
To edit the comment, click the comment icon. The comment window appears, allowing you to modify the comment text.
If you frequently access the same location in your file (for example, a scene that needs revising), you can bookmark it so that you can get back to it quickly in the future.
To create a bookmark:
To return to a bookmarked location:
The bookmarked location is displayed in the Main view.
Story sheets are customizable forms tailored for novel writing and screenwriting. They help you keep relevant information about story elements (such as plot, character, and setting) readily accessible while you are writing.
You can use the story sheets to record information such as a character’s physical description, details about a setting, or notes about what happens in a particular section of your story.
A section/scene sheet is a story sheet that contains your notes on a section of your manuscript or a scene in your screenplay.
The Synopsis Area
The Synopsis area holds your summary of the section.
The Section Details Area
The Section Details area contains context-sensitive fields to record section-specific details. There are three standard fields:
You can add new fields or replace the existing ones. For more information, see “Editing a Field.”
The Section Notes Area
The Section Notes field holds any additional notes on the section you want to make.
A character sheet is a story sheet used to organize notes on a character. The sheet has four sections:
The Summary Area
This summary section is used for entering a high-level summary of the character. This summary is displayed in the sheet itself and also in the Outline view and in the Storyboard view.
The Physical Description Area
This section provides context-sensitive fields for you to describe the physical aspects of the character. You can add or replace fields by clicking the field name and selecting from the menu that pops up.
The Character Development Points Area
Many writers like to track a character’s “arc” through the story. This section allows you to specify the points along the arc where your characters learn and grow (or not). To create a new character development point, click the character icon and select Add Character Point. When you know where in your manuscript this arc occurs, right-click the section link to assign it to the appropriate section.
The Notes Area
The Notes section can be used to record additional character information.
A plot sheet is a story sheet for notes on a plot point. It has four sections:
The Summary Area
This sheet, like all story sheets, has a section for entering a high-level summary of the story element. This summary is displayed in the sheet itself and also in the Outline view and in the Storyboard view.
The Section Area
This area allows you to assign a plot point to the section sheet for the section of the manuscript where the plot point occurs. Depending on your writing style, you may want to assign the plot point to a section as you are writing, or wait until you’ve fleshed out your various plot threads to make the assignment. In either case, you can assign the plot point to a section by control-clicking or right-clicking the Unassigned link and selecting the appropriate section.
The Plot Point Details Area
This section provides context-sensitive fields for you to describe the details of the plot point. You can add or replace fields by clicking the field name and selecting from the menu that pops up.
The Notes Area
The notes section can be used to record additional plot notes.
As with other story sheets, a setting sheet has several sections:
The Summary Area
This summary is displayed in the sheet itself and also in the Outline view and in the Storyboard view.
The Setting Details Area
The Setting Details section allows you to record specific details about the setting. Feel free to edit the fields to suit your needs. Note that any fields in the setting sheet are also available in the storyboard.
The Notes Area
The Notes section can be used to record additional setting notes.
Each story sheet provides a set of default fields you can use to record information about story element. In a character story sheet, for example, the default fields are Age, Gender, Eye Color, Hair Color, and Build.
Want to customize the default set? You can add, rename, and delete fields. You can even add your own fields to a story sheet to track the information you want to track.
To add a field to a story sheet:
To rename a field on a story sheet:
To remove a field from a story sheet:
To add a custom field to a story sheet:
After you’ve customized the fields on a story sheet, you may want to save the list as a template for other sheets of the same type.
To save a field list as a template:
The next time you create a story sheet of the same type, your list of fields is used in place of the default list. The template applies only to new story sheets of the same type. Any sheets you have already customized are not affected.
You can add images to your story sheets. For example, you might imagine a particular actor starring as your protagonist. Storyist allows you to import an image of the actor into the Character sheet for that character. The image appears both on the Character sheet and on the corkboard for all the characters.
To add an image to a story sheet:
Storyist lets you work with your project items (manuscripts, scripts, notebook entries and story elements) in outline form.
To edit a project item in outline form, navigate to the item, and then do one of the following:
You can add items to an outline using the Action button or the keyboard.
To add items to the outline using the Action button:
The item appears in the row after selected row at the outline level appropriate for the item.
To add items to the outline using the keyboard:
The default body text item is that which is specified as the body level style in the outline definition (for example, the Section style) and the default story element is that which is specified as the preferred contents of the enclosing folder.
To see exactly which items will be added by the keyboard shortcuts, click the Action button and view the Add menu items.
You can rearrange your outline by simply dragging items to a new location.
When you add an outline element to a text file (for example, a chapter to a manuscript), Storyist uses the file’s outline template to determine the appropriate style to apply. This way, headings are formatted correctly when you switch back to the Text View.
To edit the outline template:
Note: Outline level properties are created in order: body text first, then outline levels 1-9. The Add button is only enabled if Storyist finds a style for the next outline level (that is, a style with the outline level set to the next available outline level).
Storyboards give you a visual overview of elements of your story. You can use them to
You might use storyboards at the start of your project to get all your ideas down and organized before you start writing, or after you’ve completed a draft, to summarize and view the arc of your plot or characters.
Storyist provides two types of storyboards:
To view a story element as a Storyboard, use the Project view to navigate to the element you want to see, and then do one of the following:
To add a new item to a corkboard, do one of the following:
Some writers find it useful to setup a fixed-size corkboard so that they can visualize the act breaks of their story as they are writing. For instance, if you are writing a screenplay and are planning to have approximately 60 two-minute scenes, you might arrange your corkboard to have four rows of 15 scenes (one row for the first and third act and two rows for the second act).
To specify the layout of a corkboard:
Adding items to a collage is a simple as dragging them from the Project view to the collage.
You can arrange the items in the collage by dragging them to the desired location.
When you drag section or scene sheets to the collage for a section or scene, Storyist displays a dialog offering to attach the sheet to the section or scene.
If you choose to attach a sheet to a section or scene, Storyist transfers the title and synopsis from the sheet to the index card and keeps the titles and summaries synchronized so that update to the title or summary of one will be reflected in the other. Attaching sheets in this manner reduces the overhead of keeping per-section or per-scene notes. Choose this option if the sheet you are attaching describes the section or scene you are attaching it to.
If you choose not to attach the sheet to the section or scene, Storyist will add the sheet to the storyboard, but keep the titles and summaries separate. Choose this option if you simply want to have quick access to a sheet for another section or scene.
The ability to have section or scene sheets in either an attached or an unattached state enables several story development workflows:
If you have ideas for scenes, you can create sheets for them, and develop the scenes before you start writing. Then, when you understand where in the story your scenes belong, you can drag the sheets to the scene’s collage and attach the sheet to the scene. Your notes are then transferred to the scene’s index card.
Once you attach a sheet to a section or scene, and any changes you make to the scene’s card will be reflected in the sheet. Similarly, any changes you make to the sheet will be reflected in the scene’s card, freeing you to focus on writing.
If you later decide that a section or scene no longer meets your original goals, you can detach the sheet from the scene (by deleting it from the collage) and optionally attach it to another scene.
You can change the size of the items on the Storyboard using any of these three methods:
If you are working with a collage, you can also adjust the size of individual items.
To resize a collage item:
Normally, dragging a resize handle preserves the aspect ratio of an item by changing both the height and the width of the item simultaneously. Holding down the Option key while dragging allows you to change the height and width independently.
By default, Storyist represents characters and settings as images and all other items as index cards. You can change the representation of an item using the Action button in the control bar.
To change the representation of an item:
To get a better visual overview of your story, you can color-code your index cards. To change the color of an index card in a storyboard:
A Storyist project contains your manuscripts and scripts, and your story sheets for plot, character, and setting.
It can also hold many types of ancillary information. For example, you might use it to store bits of dialog, clippings, research, or query letters.
The Project View—located at the left of the main window—helps you organize and access these project items quickly.
There are several ways to add items to your project:
Note: If an item is selected in the Project view when you add a new item, Storyist will add the new item after the selected item if possible. If nothing is selected in the Project view, Storyist will add new items to the default location for the item type.
Tip: If you select an item in the project view and then click the Add button in the Project view while holding the Option key, a new item of the same type as the selected item is created.
In addition to using the Project view to add project items to the project, you can use it to add outline elements (for example, chapters, sections, and scenes) to manuscript or script project items.
To add an outline element to a text file:
Note: Storyist determines whether or not to display a text item’s outline in the Project view by examining the text file’s outline template. You can edit the outline template by selecting the File Info pane in the inspector and clicking Edit Outline Template.
Note: By default, the Project view displays outlines for text files that have outlining enabled. If you don’t want to see the text file outline in the Project view, click the Action button in the Project view and choose “Hide Text File Outlines.”
You can enable or disable outlining for a text file, using the “Enable outlining for this file” checkbox in the File Info pane in the inspector.
Also, the list of outline elements displayed in the menu is generated from the outline template.
To delete items from the project:
The items you selected are moved to the project Trash.
To view the contents of the project trash, click the View button in the toolbar and choose Show Project Trash.
To Empty the Project Trash, click the Empty button at the top of the trash list. Be careful with this. You can’t undo this operation.
Storyist provides default settings for project items, but you can edit the settings to specify things like editor behavior and preferred contents of a particular folder.
To edit the preferences for a project item, open the inspector and select the File Info pane.
The file name and icon appear at the top. Additional preferences are displayed according to the type of item selected. These preferences are detailed below.
Text File Preferences
Kind—A pop-up menu specifying the editor features enabled for the file. Available values are:
Enable outlining for this file—Clicking this checkbox causes the file’s outline elements (that is, the chapters and sections or scenes that make up the file) to appear in the Project and Outline views. This checkbox is checked by default for manuscripts and scripts, but disabled for notebook entries.
Include body text elements—Clicking this checkbox causes the file’s body text sections to appear in the outline. This checkbox is checked by default for manuscripts and scripts, but disabled for others.
Edit Outline Template—Clicking this button brings up a dialog that lets you edit the outline template (level labels and styles) for the file.
Create sheets automatically—Clicking this causes Storyist to create a section or scene sheet when new sections or scenes are created.
Shortcuts—You can specify whether or not Storyist enables Tab and Return shortcut processing in the file. If you choose “Use the application preferences,” Storyist will use the settings you specify in the application preferences (accessed from the Storyist > Preferences window).
Contents—Specifies the preferred contents for the folder. Storyist uses this value to provide keyboard shortcuts (Command-Return and Command-Slash) for the Project view and Outline view, and to decide where to put new files if nothing is selected in the Project view.
Note: Preferences for some kinds of project items are not available. For these items, choosing Edit simply displays a dialog showing the item title and kind.
One of the benefits of having all your project-related writing in one place is that the contents are instantly searchable.
To search for text in your project:
Your search results appear in the Project view. To navigate to the file or story element that contains the search text, simply click a search result.
When you’re writing, you probably want to arrange your windows and views to focus on the manuscript or screenplay. When you’re outlining, you likely want to use the Outline view. When you’re revising, you may want to see the manuscript and screenplay along with your notes.
It can be cumbersome to size your views and configure the display preferences to suit your needs, so Storyist provides the ability to create workspace snapshots to quickly recall your settings.
You can split a view horizontally or vertically. Storyist even lets you nest split views, so you can create quite complex view arrangements.
To split a view, position the cursor in the view you want to split, and then choose one of the following:
To close the active split view, choose View > Split > Close Active Split View.
To close all split views but the currently active view, choose View > Split > Close Others.
If you want to change the orientation of a split view (that is, you want to change from a vertical split to a horizontal split or vice versa), choose Window > Workspaces > Rotate Workspace.
Note: This command changes the orientation of the outer split views. Nested split views are not affected.
Sometimes it is useful to have multiple project windows open. Not only can you see multiple project documents at one time, you can take advantage of Spaces to streamline your workflow.
To open a new project window. choose File > New > Window.
When you have your windows and views arranged to your liking, you can take a snapshot for later recall.
Workspace snapshots contain:
To create a new workspace, do one of the following:
The Workspaces window lets you create, update, switch between, and delete workspaces.
To view the Workspaces window, choose Window > Workspaces > Manage Workspaces.
To add a workspace for the current project configuration, click the Add button.
From time to time, you may want to update the image or settings for a workspace you use frequently.
To update an existing workspace:
Storyist lets you set word count goals for both your daily writing sessions and your entire project, and helps you track your progress over time.
To set word count goals:
The result will look something like this: ￼
Note, you can also edit your word count goals by clicking on the Project item in the Project view and opening the File Info inspector.
After you’ve set up your writing goals for the project, you can track your progress in several ways.
The calendar view displays your word count progress in calendar form. Days on which you’ve achieved your goal are shown in green. Days on which you’ve achieved at least fifty percent of your goal are shown in yellow. Days on which you’ve written something, but achieved less than fifty percent of your goal are shown in red.
To see the calendar view, click the Goals button in the toolbar, click the Action button, and choose Show Calendar. Alternately, you can click the first of three page buttons at the bottom of the Goals popover. ￼
You can browse results from earlier sessions by clicking on a date. Clicking on the left arrow shows the previous month. Clicking on the next arrow shows the following month. Clicking on the dot next to the left or right arrows resets the calendar to the current date.
The graph view shows you a graph of your word count progress in graph form. You can choose the range of dates you want to see, and you can browse through past writing sessions using the arrow keys.
To see the graph view, click the Goals button in the toolbar, click the Action button, and choose Show Graph. Alternately, you can click the second of three page buttons at the bottom of the Goals popover.
The summary view shows you summaries of your word count progress. The stats include:
As with the graph view, you can choose the range of dates you want to see.
To see the summary view, click the Goals button in the toolbar, click the Action button, and choose Show Summary. Alternately, you can click the third of three page buttons at the bottom of the Goals popover.
You can also configure the Status Bar to show both your total project word count and your progress toward that goal.
To do so:
When your manuscript is complete, you can create print-ready PDFs to send to a professional book printing service like Blurb.
The process is straightforward:
To add a new book to your project:
The built-in templates provide a starting point for further customization, and include beautifully designed style sheets and default settings for page size and bleed.
PDF Edition–A general-purpose template, set in Baskerville, suitable for both fiction and nonfiction.
Blurb Trade Book (Classic)–Set in Georgia, this template provides a classic design for novels and memoirs. The template conforms to the page size, margin, and bleed requirements for Blurb Trade Books.
Blurb Trade Book (Modern)–Set in Helvetica, this template provides a modern design for general non-fiction. The template conforms to the page size, margin, and bleed requirements for Blurb Trade Books.
A new book has no content. To add files from your Storyist project to the book:
You can also drag text files directly from the Project view.
By default, Storyist assumes that the files you add from the project are part of the book text (not the front matter or back matter). You can change the file’s role in the book by opening the Formatting inspector and setting the Role pop-up button to the appropriate value.
If you don’t want the file’s headings to appear in the table of contents:
Storyist can automatically create and maintain a table of contents for your book.
The page (trim) size of your book is often different than the size of your manuscript pages.
To set the page size for your book:
To set the margins:
If you’re creating a book for print, check the Mirror Pages checkbox. This will change the Left and Right margin labels to Outside and Inside. Make sure that you allow a wide enough margin on the inside of the page spread that the text on your pages doesn’t disappear into the binding. Book printers post minimum recommended margins on their websites.
On a press, pages are printed on paper that is slightly larger than needed and then trimmed down to size the final page (or trim) size. Bleed is printing that goes beyond the edge of where the sheet will be trimmed. Book printers post minimum required bleed settings on their websites too.
To set the bleed:
As with margins, if you’re printing a book, you can check the “Mirror Pages” checkbox so that the left and right bleed settings instead specify the outside/inside values.
You can view the margin and bleed boxes using the View > Layout > Show Page Guides command.
Each book template comes with a style sheet that specifies the look of the headers, footers, headings and body text for the book. If the “Apply formatting from template” checkbox (located in the Styles pane in the Formatting inspector) is checked when you build the book, Storyist will reformat your source (project) files with the style sheet from the template.
You can control which source styles are mapped to which template styles using the table in the Styles pane.
The “Styles in Use” column lists the styles that are currently used in your source file. The “Replacement” column lists the styles from the template that will be used instead. Click on a style in the replacement column to see the list of available template styles.
Note: The formatting of the source file remains unchanged. The changes appear only in the book.
If you’d prefer to specify the formatting yourself, leave the “Apply formatting from template” checkbox unchecked and make the formatting changes in the source file instead.
The Layout & Substitutions pane in the Formatting inspector lets you perform some common textual substitutions when building the book.
The Pagination pane in the Formatting inspector lets you control the starting page and starting page number of the selected file(s).
The “Start on” pop-up button controls the starting page. Options are:
The page numbering radio buttons let you restart the page numbering for the selected file at a particular value. It’s customary for the book body text to start at page 1, even though the title page and table of contents pages precede the book body.
The book editor shows a preview of the PDF that will be created when you export your book. You can update the preview after you make changes to the contents or formatting by clicking the “Build PDF” button in the File table.
You can also preview the PDF in the Preview app by clicking on the Action (gear) menu in the Files table and choosing “Open with Preview.”
At some point, you might want to fine tune the formatting that the PDF template applies to your text.
For simple edits (for example, adding bold or italics), you can simply modify the content in the source file and click Rebuild PDF. For more advanced edits, you can import an editable version of the PDF to your project and edit that file instead.
To fine tune the template formatting:
When you’re happy with the preview of the book, click the Action (gear) button in the File table and choose Export. You’ll be prompted for a location to save the exported PDF.
You can also export the PDF using the export interface. To use this method, choose File > Export, select the book item, and click Next.
Blurb is a popular self-publishing platform that provides professional printing, global fulfillment, distribution to Amazon and Ingram, and a free ISBN.
Storyist comes with several templates that conform to the page size, margin and bleed requirements for Blurb Trade Books, so it’s easy to go from manuscript to printed book.
To get started, visit <Blurb/Storyist URL> and follow the instructions there.
Storyist automatically saves a copy of your work every few minutes to help minimize data loss in case of power failure or other unforeseen circumstances. If Storyist should quit unexpectedly, it will restore your project from the automatically saved copy the next time you launch the application.
For newly created projects, Storyist saves your changes in a temporary location on your hard disk. After you save your new project to its permanent location, Storyist continues automatically saving your work to the location you’ve chosen.
Storyist also begins making periodic copies of your entire project. These copies are referred to as versions. Versions are created each time you open a project and every hour while you’re working on it.
You can view these automatically saved versions and compare them to the current project using the Versions Browser as follows:
The Versions Browser is integrated with Apple’s Time Machine backup software, so if you set up Time Machine, you’ll be able to browse versions that are saved not only on your local machine, but on your Time Machine hard drive as well.
To make efficient use of space, OS X periodically prunes the automatically created version of a project on your hard drive, keeping hourly versions for a day, daily versions for a month, and weekly versions for all previous months.
OS X does not prune any versions you create manually (see below).
Note: If you prefer to see a simple list of previous versions, you can use the File > Show Previous Versions command.
You can also save a version of your work manually. You might choose to do this after completing a draft, before starting a round of revisions, or before trying a scene you are not sure you’re going to keep.
To save a version manually:
If you’re not happy with the changes you’ve made to your story, it is easy to return to a previously saved version:
The project now contains the contents of the previous version of your project.
Storyist can export project items to disk as individual files or it can combine them and export them as a single eBook.
To export project items as either individual files or a single eBook:
When you choose the “Files” option in the Export popup button in the export dialog, the Format popup button presents the following file format options:
Note: Image items are exported in their native format. That is, they are exported in the format they were in when added to the project.
When you click the Next button in the export dialog, Storyist begins the export process. For the file export process, there is only one step.
This pane has two check boxes:
You can optionally have Storyist guide you through the individual steps of the workflow by checking the “Guide me through the workflow steps” checkbox. If you select this option, Storyist adds additional steps (panes) to the export process, one for each workflow action, allowing you to adjust the settings.
The Edit Workflow button opens the selected workflow in Automator for editing. If the selected workflow is a built-in workflow, Storyist first makes a copy of the workflow in the Library/Application Support/Storyist/Workflows/Export folder in your home directory.
The Show Workflow Folder button opens the workflow folder in Finder. Workflows are located in the Library/Application Support/Storyist/Workflows/Export folder in your home directory. If you create your own workflow with Automator, be sure to save the workflow in this folder.
Note: Workflows created with Automator must consist only of actions that take “Storyist Styled Text” for input and output. For more information on using Automator, please see the Automator User’s Guide.
To create an eBook, choose the “eBook” option in the Export popup button in the export dialog. Storyist can create both ePub and Kindle eBooks.
When you click the Next button in the export dialog, Storyist begins the export process. There are two steps in the eBook export process:
These steps are described below.
Using drag and drop, arrange the project items in the order they should appear in the publication.
You can optionally specify the eBook role (a value used by some eBook software to provide additional information to the reader) using the eBook Role popup menu. The options are:
If you’re not sure which roles to use, choose “Cover” for the cover image, and “Book Body” for everything else.
eBooks contain metadata (card catalog) information describing the contents of the eBook. In this step, enter the following:
You can optionally include other metadata items by clicking the Add button in the metadata table and choosing the metadata item names from the popup. The available items are:
Note: These metadata terms correspond to those specified by the Dublin Core® Metadata Initiative. See http://dublincore.org for more information.
After you’ve selected the items you want to export and entered the export setting information, you can save your item selection and settings as a preset to use the next time you use the export command.
To save export settings as a preset:
To restore the item selection and export settings from a preset: