Documentation

Conversion Settings

When converting files through the Digital Hub, depending on the type of conversion, users can select whether to enable or disable the following actions.

Conversions into .scml

Rebuild Table of Contents

Default: Disabled

The Digital Hub will attempt to link the existing table of contents (TOC) to corresponding chapter heads and similar elements. The resulting links will be most accurate when these elements match the TOC entries. Modification of the TOC only applies to the .sam to .scml conversion, which is also part of the Word to ePub2 conversion and the InDesign XML to ePub2 conversion. After an .scml file is created, the TOC will not be altered by any conversion process run on that file.

If this setting is enabled, the Digital Hub will generate a table of contents automatically from text scribed as any of the following: part number and/or part title; chapter number and/or chapter title; A-, B-, or C-level head; front matter title; or back matter title. If a file already contains a table of contents, it will be deleted during this process.

Note: The Hub uses the TOC to generate the ePub navigation elements.

Embed Index Terms at Page Anchors

Default: Disabled

If this setting is enabled, the Digital Hub will embed terms and subentries from an index that follows the Chicago Manual of Style formatting as metadata at the appropriate page anchors in ScML.

Place Footnotes at End of Chapter

Default: Disabled

If this setting is enabled, when the Digital Hub converts footnotes embedded in a document, it will place the footnotes at the end of their respective chapters instead of at the end of the file.

Renumber Footnotes by Chapter

Default: Disabled

If this setting is enabled, when the Digital Hub converts footnotes, it will renumber them, starting at 1 for each chapter.

Reletter Footnotes by Chapter

Default: Disabled

If this setting is enabled, when the Digital Hub converts footnotes, it will reletter them, starting at “a” for each chapter. When more than 26 notes are included in a chapter, the lettering will restart at “aa.”

Conversions into ePub

Default: Enabled

The Digital Hub will link the first chapter-level head in each chapter (typically the chapter number or chapter title) back to the table of contents.

Small Caps Backward Compatibility

Default: Enabled

The Digital Hub will remove the small caps style from uppercase letters, and it will capitalize and maintain the small caps style for lowercase letters. True small caps rendering is not available in older e-readers. This procedure, however, when combined with setting the font size at 80 percent or less for the small caps style in the project’s CSS, will enable small caps text to render properly in older as well as newer e-readers.

Default: Enabled

The Digital Hub will link each footnote or endnote number (fnnum or ennum) back to an in-text marker (fnref or enref) based on the order in which each appears.

Note: Footnote numbers (fnnum) occur at the start of footnote paragraphs (fn). Endnote numbers (ennum) occur at the start of endnote paragraphs (en).

Nest E-Reader Table of Contents Items

Default: Enabled

When producing an ePub, the Digital Hub will nest the table of contents entries in the navigation document (the toc.ncx or toc.xhtml file) based on their hierarchy.

Conversions into HTML

Include Blank Style Sheet

Default: Disabled

If this setting is enabled, when the Digital Hub converts an ScML file to HTML, it will embed a blank style sheet listing every style used in the document in the head of the HTML.

Pop-Up Footnotes

Default: Disabled

If this setting is enabled, when the Digital Hub converts an ScML file to HTML, it will include JavaScript embedded in the HTML that will make the footnotes interactive pop-up boxes. This is not available for ePub conversions.

Conversions into IDTT

Add Note Tabs

Default: Enabled

The Digital Hub will add a tab at the beginning of each note (fn or en) that is not embedded and a tab following its number or marker (fnnum or ennum) if it doesn’t already have one in each of those positions. Having tabs will make it easier to decimal align or right align note numbers or markers in the typeset.

Add List Tabs

Default: Enabled

The Digital Hub will add a tab at the beginning of each numbered list item (nl) if it doesn’t already have one. Having tabs will make it easier to decimal align or right align the list numbers in the typeset.

Standardize Ellipses

Default: Enabled

The Digital Hub will format all ellipses as periods separated by nonbreaking spaces and will adjust any surrounding space to conform to the rules of the Chicago Manual of Style and general conventions. This includes closing up the space when adjacent to quotation marks, parentheses, or em dashes. It will omit the space after an ellipsis when followed by an apostrophe (starting a contracted word, for example). Disable this setting or double-check the output, depending on how often that combination might occur in the project.

Embed Footnotes

Default: Enabled

If the quantity of footnote markers (fnref) matches the quantity of footnote numbers (fnnum), the Digital Hub will embed the footnotes. If the counts do not match, it will not embed the footnotes. Embedding the footnotes enables automatic placement within the typeset using InDesign’s Document Footnote Options. It is not recommended to allow footnotes to be embedded within table cells, as the result typically will not work for the desired outcome in InDesign.

Enhanced Bible IDTT Output

Default: Disabled

If this setting is enabled, the Digital Hub will apply the following changes to the file:

  • Apply alternative styles to paragraph-level elements containing verse numbers (ver) based on whether the number has one, two, or three digits (e.g., sl-v2)
  • Add tabs after every verse number (ver)
  • Place a thin space between all adjacent quotation marks

Scribe Diacritics and Fractions

Default: Disabled

If this setting is enabled, the Digital Hub will apply a dcrit character style to characters belonging to the Latin Extended-A Unicode block and will apply a frac character style to single-glyph fractions.

Print-Specific Head Styles for Front and Back Matter

Default: Disabled

If this setting is enabled, in IDTT output, the Digital Hub will append “-altfm” to the style tags of body heads in the front matter and “-altbm” to the style tags of body heads in the back matter.

Conversions into Word

Remove Cross-References

Default: Disabled

If this setting is enabled, the Digital Hub will remove all cross-reference (xref) styles. The content of the cross-reference (the text itself), however, will not change. Cross-reference styles are very helpful in digital publications but might not be useful in a document intended for editing.

Remove Structure Indicators

Default: Disabled

If this setting is enabled, the Digital Hub will not include structure indicators (i.e., <structure>) when outputting a Word file.

Remove Page Indicators

Default: Enabled

The Digital Hub will not include page indicators (maintained from typeset files) when outputting a Word file.

Use Embedded MS Word Notes

Default: Enabled

If this setting is enabled, when the Digital Hub produces MS Word output, it will embed the footnotes and endnotes using Word’s native note feature.

Conversions from Word

Convert Notes

Default: Enabled

The Digital Hub will remove footnotes and endnotes embedded in a Word document and will place them at the end of the resulting file. Note markers other than numbers, letters, or Roman numerals (asterisk, dagger, etc.) will be replaced with numbers.

Unnest Note Heads

Default: Enabled

When the Digital Hub converts footnotes and endnotes embedded in a Word document, it will move any section heads appearing within the footnotes or endnotes outside of the note tags.

Place Footnotes after Section Breaks

Default: Disabled

If this setting is enabled, when the Digital Hub converts footnotes embedded in a Word document, it will place footnotes at the end of their respective section of the document instead of at the end of the file.

Place Endnotes after Section Breaks

Default: Disabled

If this setting is enabled, when the Digital Hub converts endnotes embedded in a Word document, it will place endnotes at the end of their respective section of the refined Word document instead of at the end of the file.

Retain MS Word Images

Default: Disabled

If this setting is enabled, when the Digital Hub converts an MS Word document to sam, it will replace any images in the Word document with the Scribe image query format and add the image to the project assets.

Refiner: Conversions from Word into Word

Articulate Spacing Distinctions for MS Word

Default: Enabled

When using the MS Word Refiner, the Digital Hub will apply the scribing distinctions necessary to achieve proper spacing in a typeset book or an e-book. For example, it will adjust the scribing of block quote (bq) paragraphs to make use of first, last, and stand-alone variations (bqf, bql, and bqs). This makes it possible to have extra space above or below a paragraph (or both above and below), as would be appropriate to the context. (See Articulation for additional examples.)

Convert Notes in MS Word

Default: Disabled

The Digital Hub will remove footnotes and endnotes embedded in a Word document and will place them at the end of the refined MS Word document. Note markers other than numbers, letters, or Roman numerals (asterisk, dagger, etc.) will be replaced with numbers.

Place Footnotes after Section Breaks in MS Word

Default: Disabled

If this setting is enabled, when the Digital Hub converts footnotes embedded in a Word document, it will place footnotes at the end of their respective section of the refined Word document instead of at the end of the file.

Place Endnotes after Section Breaks in MS Word

Default: Disabled

If this setting is enabled, when the Digital Hub converts endnotes embedded in a Word document, it will place endnotes at the end of their respective section of the document instead of at the end of the file.

Apply ScML Template Definitions

Default: Enabled

If enabled, the Hub will clear any locally applied paragraph formatting in the MS Word Refiner. This allows the formatting associated with the paragraph’s ScML style in the template to display correctly.

Various Conversions

Scribe Language Styles

Default: Disabled

If this setting is enabled, the Digital Hub will identify words containing characters outside the basic ASCII range. It will use the Chromium Compact Language Detector, the same software Google uses, to guess the language of each word or phrase. The software sometimes misidentifies the language, but it has a better than 90 percent accuracy rate. The Digital Hub will add a “lang” attribute (with a two-letter code, ISO 639-1) to mark the identified text. Identifying the language is helpful for determining the appropriate direction of the text and selecting typesetting fonts.

Articulate Spacing Distinctions

Default: Disabled

If this setting is enabled, the Digital Hub will apply the scribing distinctions necessary to achieve proper spacing in a typeset book or an e-book. For example, it will adjust the scribing of block quote (bq) paragraphs to make use of first, last, and stand-alone variations (bqf, bql, and bqs). This makes it possible to have extra space above or below a paragraph (or both above and below), as would be appropriate to the context. (See Articulation for additional examples.)

Adjust Typesetter Tabs

Default: Disabled

If this setting is enabled, when converting from InDesign XML, the Digital Hub will change known tab-spacing patterns used for typeset purposes (including tabs around the numbers in lists, footnotes, and endnotes) to spacing appropriate for digital formats.

Visible Page Markers

Default: Disabled

If this setting is enabled, when the Digital Hub converts an ScML file to ePub 3 or HTML, it will include the page number as live text where the page number is indicated. This is not recommended for standard use.