Documentation

SAI Editorial Tools

Editorial tools and functions within the SAI.

Editorial Style Sheet

Not available for Word 2016 (Mac) version of SAI at this time.

Creates a style sheet in the active file directory or opens an existing style sheet.

Fill in the fields of the dialog box that appears. Fields marked with an * are required.This feature includes an option to populate the style sheet with certain terms such as capitalized terms, acronyms and initialisms, and abbreviations. If you choose to populate the style sheet, you can also choose to include b-styled (bold) words, i-styled (italic) words, and/or text with other character styles applied (e.g., bi [bold-italic], sm [small caps], gt [glossary term], etc.). List desired styles in a comma-separated list in the box provided.

  • Load Existing: Click this button to turn an existing style sheet template into an SAI-enabled style sheet. Generally, this means ensuring that the style sheet has a properly formatted alphabetical list option and a compliant naming scheme.
  • Open Existing: This opens an existing SAI-enabled style sheet, whether created by the SAI or loaded and formatted previously through the Load Existing option.

Populate Style Sheet

Checks the document for the following: acronyms, words in all-caps, capitalized terms that do not seem to begin a sentence, oddly capitalized words (e.g., iPod), email addresses, and Twitter handles.

These terms are added to the Alphabetical List portion of the style sheet and sorted alphabetically. This feature works best on well-composed files using the ScML template.

Editorial review of this list is expected; it is neither a comprehensive list of every special term in the document nor devoid of “false positives.” It should be considered an editorial starting point.

This feature requires that an editorial style sheet has been created via the SAI and that it is open. The style sheet needs to be named [project name]-999Style.doc (e.g., scr-test-999Style.doc). This feature allows the editor to pull in terms from multiple files as each is edited. Specifically, it can be run on a new style sheet when it is created (via Editorial Style Sheet) or on an existing style sheet that is open (via Populate Style Sheet). The context menu also provides a way to add individual words or phrases to the open style sheet (see Other Features).

Add to Stylesheet

Adds selected text to the open style sheet.

Open the document’s style sheet, then select a word (or phrase) in the main document and right-click it to open the context menu. Click this option, and the selected text will be added to the style sheet, correctly alphabetized.

Add Name to Stylesheet

Adds selected text to the open style sheet as an inverted name.

Open the document’s style sheet, then select a name in the main document and right-click it to open the context menu. Click this option, and the selected text will be added to the style sheet, inverted around the last space and correctly alphabetized. Names that already contain a comma will be inserted as is.

Add Title to Stylesheet

Adds selected text to the open style sheet.

Open the document’s style sheet, then select a title in the main document and right-click it to open the context menu. Click this option, and the selected text will be added to the style sheet, inverted around its article and correctly alphabetized. Titles that don't being with an article will be inserted as is.

Title Case

Applies “intelligent” title case to the selected text; capitalizes words based, as much as possible, on rules of the style specified in your preferences.

An editorial eye should still be applied to significant prepositions, Latin terms, and other exceptions to the general rules of capitalization. (This feature is also available from the Context Menu.) See User Settings to set style preferences.

Add Word to Capitalization Dictionary

Adds the selected word (as capitalized) to the capitalization dictionary of your choice.

Select a word with atypical title case capitalization. Right-click it to open the context menu. Click this option and choose the capitalization dictionary to which you want to add the word.

Insert Queries

Inserts Word comments for any of the options chosen from the drop-down menu.

Each comment’s initials/author name indicates to whom the comment is addressed.

Standard Word comments are not allowed in embedded notes; however, the SAI allows for queries to be created in the same manner. They will appear as regular text, formatted using Scribe’s query convention ({~?~[text]}).

  • AQ Author Query: Inserts an author query and allows navigation among author queries. Also use to edit and navigate author queries.
  • IQ Internal Query: Inserts an internal query and allows navigation among internal queries. Also use to edit and navigate internal queries.
  • TN Typesetter Note: Inserts a typesetter note and allows navigation among typesetter notes. Also use to edit and navigate typesetter notes.
  • IM Image Callout: Inserts an image insertion note formatted for processing through Scribe’s Digital Hub. You will be prompted to enter the figure’s file name (provide the file name only, not the full path).

Note: Queries should not be inserted next to or within structure indicators, as this can interfere with processing through the Hub. Queries relating to an entire structure are best placed on the first line of text within that structure.

Insert AutoText in queries. This feature is available for all query types (AQ, IQ, and TN). It makes any AutoText that has been saved in Word's Normal template available to insert into queries. In the query window, place your cursor where you want the AutoText to be inserted, then tab over to the Insert AutoText Entry box and hit enter to select and insert the text. The AutoText will appear as part of the query. This can be useful when inserting standardized editorial or production notes.

The checkbox options next to the main Insert Query button allow you to select view options. For example, to view only the author queries, check the Show AQ box but uncheck the Show IQ and Show TN boxes. (You can also adjust the query/note view settings under Word’s Review tab, Show Markup drop-down menu, Reviewers.)

There is no need to remove Word comments before uploading files to Scribe’s Digital Hub. The Hub will convert the Word comments into text comments marked with query formatting ({~?~[text]}).