Documentation

Word Composition

Composition is the act of applying structure to content, resulting in a file that conforms to standards of best practices for editorial and production processes. In Word and InDesign, this is done by applying styles to elements in publications.

References/Prerequisites

References, prerequisites, and common composition considerations are listed here.

Procedure

1. Apply the ScML Template

Click Apply ScML Template in the SAI toolbar.

If user-defined styles can be mapped to ScML styles, associate styles at this time.

2. Check for Graphics

If there are images embedded in the Word file, replace them with callouts.

Note: Any graphics remaining in the Word file will be replaced with callouts during conversions through the Digital Hub, with the graphics saved into the project’s image assets. This should be considered a safety net to preserve any graphics that may otherwise have been lost; the best practice is still to handle graphics outside of a Word document.

3. Compose Part/Chapter Titles and Heads

Compose all the part titles, chapter titles, and heads throughout the document.

For stacked heads, compose only with the basic head style (e.g., ah, bh, ch). Do not apply “aft” variations of heads except for ahaft if an a-head precedes the first regular paragraph in a chapter.

In addition to heads, compose any paragraph that is using a particular rendering as the base font (e.g., if all sense line paragraphs are using italics). This will remove the italics for you when a new paragraph style is applied and ensure that you don’t have to go back and remove character styles by hand.

4. Run Rendering Cleanup in the SAI

In the SAI, go to the Cleanup window.

1. File Selection

In File Selection, select which files and which parts of files are to be changed.

Note: By default, the Cleanup tool will run on the main text, footnotes, and endnotes of the active file.

2. Settings

In Settings, select Rendering to apply ScML styles to Word’s character rendering.

5. Compose Space-Break Paragraphs

Compose any elements whose distinction would be lost when empty hard returns, multiple spaces, or tabs are deleted.

This includes, but is not limited to, the following:

  • unornamented section breaks (psec)
  • continued paragraphs following interrupting elements (pcon, ntcon)
  • poetry stanza breaks
  • copyright data
  • code lines
  • adjacent standalone paragraphs (refining the document will provide proper spacing articulation)

6. Compose Remaining Non-p Paragraphs (With Some Exceptions)

At this time, do not compose spacing variations (f, l, s, or o) other than those listed in the previous step. Identify only the structural aspects of the paragraph. A later step will use the Refiner to add the spacing variations.

Compose any paragraph that is not p, pf, paft, td, a list generated by Word , or an endnote/footnote using Word’s “Endnote Text” or “Footnote Text” styles. This includes, but is not limited to, the following:

  • block quotations
  • epigraphs
  • sidebars
  • figures
  • table content that is not td

To cycle through remaining special elements in the book, open up a style gallery, check “Autoselect Next Para. Group,” “Skip ScML Paragraph,” and “Skip Likely <p> Paragraph.” Apply a style or skip as appropriate.

7. Compose the Character Styles

Identify any character styles that need to be differentiated from standard i, b, or sm styles.

This includes, but is not limited to, the following:

  • dispk
  • fighn
  • thn
  • hemb

Apply “Default Paragraph Font” to remove character styles as needed.

8. Insert Structure Indicators

Insert structure indicators to identify sections that do not include part or chapter titles (such as front matter sections preceding the Table of Contents).

Insert structure indicators to group or separate complex structures, as needed.

Structure indicators can be inserted using the SAI’s Insert Structure Indicators button.

Structure indicators do not need to be inserted for elements that follow the default behaviors of paragraph groups.

For more information on Structure indicators, see Structure Indicators in Word.

9. Run Cleanup Options in the SAI

The Refiner process in the Digital Hub can perform many of the actions available through the SAI’s Cleanup Options. You may choose to use the Refiner before continuing with the SAI’s Cleanup Options for some documents.

In the SAI, go to the Cleanup window.

1. File Selection

In File Selection, select which files and which parts of files are to be changed.

By default, the Cleanup tool will run on the main text, footnotes, and endnotes of the active file.

2. Settings

In Settings, check the cleanup and formatting options to be used.

Select the following:

  • Spaces
  • Paragraphs
  • Rendering

If required, further cleanups can be marked at this time. For more information on the SAI’s Cleanup Options, see SAI Tools.

10. Refine the Document

Upload the file to the Digital Hub and run the Refiner (MS Word Document to Refined MS Word Document conversion) to apply spacing distinctions.

Settings available for the Refiner include the following:

  • Convert Notes
  • Place Footnotes at Section Breaks
  • Place Endnotes at Section Breaks
  • Articulate Spacing Distinctions for MS Word

11. Final Cleanup and File Check

Run File Check in the SAI.

Upload the .docx file to the Digital Hub. View the Alerts tab and Stats and Checks fields to identify potential errors.

Potential errors include the following:

  • en/enref/ennum or fn/fnref/fnnum counts not matching
  • combining Unicode characters in use
  • missing or duplicated structure indicators

Convert the .docx to .sam in the Digital Hub and run the text checks listed in the Composition QC Checklist.