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/ePub

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 delete the existing table of contents chapter and will replace it with one generated automatically from text composed as any of the following: part number; part title; chapter number; chapter title; A-, B-, or C-level head; front matter title; or back matter title.

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 (fn or en) back to an in-text marker (fnref or enref) based on the order in which each appears.

Nest Navigation Document TOC Entries

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.

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.

Conversions into HTML

Include Blank Stylesheet

Default: Disabled

If this setting is enabled, when the Digital Hub converts an ScML file to HTML, it will embed a blank stylesheet 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. Because InDesign cannot handle a footnote embedded in a table cell, the Digital Hub will not embed the footnotes if any footnote marker (fnref) is located within a table cell.

Enhance 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

Compose 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.

Articulate Spacing Distinctions for MS Word

Default: Enabled

When using the MS Word Refiner, the Digital Hub will apply the compositional distinctions necessary to achieve proper spacing in a typeset book or an e-book. For example, it will adjust the composition of block quote (bq) paragraphs to make use of first, last, and stand-alone variations (bqf, bql, and bqs), following Scribe rules for composition. 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.)

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 at 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 at 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 document instead of at the end of the file.

Various Conversions

Compose 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 compositional distinctions necessary to achieve proper spacing in a typeset book or an e-book. For example, it will adjust the composition of block quote (bq) paragraphs to make use of first, last, and stand-alone variations (bqf, bql, and bqs), following Scribe rules for composition. 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.