Table of Contents

The Table of Contents shows you the structure of your manuscript by laying out how your discourse elements fit together.

Note that you can use the Table of Contents as an outliner–construct the structure of your manuscript as you wish, move discourse elements up and down, such that this outline fits your narrative. You can add the content of each discourse element later, or as you go along.

Double-click on the name of any element (including the manuscript) to change its name.

Table of Contents Menu

Click on the menu button toward the right of the table of content header to open the menu shown in the image above.

This menu offers the following functionality:

  • Desync from editor and Sync with Editor: Normally, clicking on the name of a discourse element will move the content in the editor pane to the top of that element. If you enable Desync from editor, you can move around in the table of contents by clicking, and scroll in the editor pane independently. This menu option works as a toggle.

  • Collapse all and Expand all: Clicking on this menu option will either collapse the entire tree of discourse elements. This option works as a toggle.

  • Export TOC: This option allows you to export the entire structure contained in the table of contents as a Word or PDF file, along with any details you may have entered for each discourse element in the details panel.

The Export TOC functionality will be implemented shortly.

Discourse Element Icons

Note that the icon next to each discourse element shows you whether it’s a chapter, scene, etc.

This icon represents your entire manuscript.

This icon marks a discourse element that is a part.

This icon marks a discourse element that is a chapter.

This icon marks a discourse element that is a section.

This icon marks a discourse element that is a scene.

As noted in the Terms and Concepts section, discourse elements can contain other discourse elements. Your manuscript can contain any other discourse element. A part can optionally contain chapters, sections, and scenes; a chapter can contain sections and scenes; a section can contain other sections or scenes. A scene cannot contain any other discourse elements.

Click and Drag Discourse Elements

You can click and drag any discourse item to move it anywhere in the table of contents. Grab the icon to the left of the discourse element with your mouse, and use it to drag that element to another place in the table of contents. In the image above, Scene C of Chapter 2 is moved above Scene B in the same chapter.

Note that you are not allowed to move a discourse element to an position where it cannot fit. For example, you cannot place a chapter within another chapter.

Discourse Element Menu

Click on the menu button toward the right of the name of any discourse element to bring up the menu in the image above.

The items in this menu will change according to the type of discourse element it is attached to (chapter, scene, etc.).

The options offered by this menu are:

  • Rename: Allows you to rename the currently selected discourse element.

  • Cut: This is the step that precedes a Paste operation (also found on the same menu). Once you cut, you can click on another discourse element and paste the earlier discourse element into its contents. Note that if you try to paste a discourse element into another discourse element that cannot contain the pasted element–such as a chapter into another chapter–the system will paste the moved element to a position under the second element.

  • Add: Allows you to add another discourse element of the same type before or after the current element. You can also add an element contained within the current element; for instance, you can add a section or scene within the currently selected chapter.

  • Convert: You can convert many discourse elements to another type. For example, you can convert a scene into a section, or chapter to a part or section.

  • Import: You can import a Word file directly into the discourse element you are currently working on. The content of the Word file will be inserted directly into the current discourse element.

  • Analyze: This option brings up the analyzer dialog (see below). This dialog allows you to see which mentions have already been created within the text of the manuscript; it also offers suggestions for other mentions that you may want to create.

  • Metrics: This option shows you the word count for the current discourse element, and also shows you a repetitiveness score, and average sentence length, and a list of overused words. See below for an explanation of what some of these metrics represent.

  • Delete: Selecting this option allows you to delete the currently selected discourse element.

  • Delete all: Selecting this option will delete the currently selected discourse element. If this element has any children, they will remain in the table of contents.

Repetitiveness score: Repetitiveness is measured as the ratio of word types to the overall count of words. Think of this as the number of unique words you use relative to the overall number of words in your current discourse element. The more often you use the same word, the more repetitive your language will appear. A higher score means less repetition because you are using more types of words relative to the overall number of words.

Overused words: How much more often does a word appear in your current discourse element when compared to the broad averages of published fiction more generally? Higher scores indicate words that appear significantly more often in your manuscript than their expected frequency.

Delete and Delete all are irreversible destructive operations. Please be careful!

Analyzer

The Analyzer option on a discourse element’s context menu will bring up the Analyzer dialog, which allows you to see existing mentions that have been created within the text, and also suggestions for possible mentions discovered by the system.

On the left, in the EXISTING column, you see the mentions that have already been created within the text. On the right, in the SUGGESTED column, you see suggestions for possible mentions that have been discovered by the system.

Within the text, existing mentions are displayed with the appropriate color as a background. The suggested mentions are displayed with a dashed line underneath.

Click on a card or a mention within the text, and the corresponding mention or card will be selected.

In the EXISTING column:

If you see an erroneous application of a mention in a card, you can click on the checkmark button to clear the checkmark to reject that suggestion.

If you see a card that needs to be corrected, click on the Edit button to change the story element it references.

In the SUGGESTED column:

If you see an erroneous suggestion for a mention in a card, you can click on the checkmark button to clear the checkmark to reject that suggestion.

If you see a card that needs to be corrected, click on the Edit button to change the story element it references.

When you have finished checking all the cards, and correcting or removing any erroneous EXISTING or SUGGESTED mentions, click on the APPLY button, and all the mentions in the Analyzer will be created in the text (or removed).