Input Configurations Tab (Project Settings Window)

This window allows you to specify settings for ePublisher input formats, also known as ePublisher adapters.

The fields are defined as follows:

Preserve condition colors in PDF 

Specifies whether you want to preserve any colors assigned to conditions in your Adobe FrameMaker source documents when you generate output.

Preserve condition styles in PDF 

Specifies whether you want to preserve any condition styles assigned to conditions in your Adobe FrameMaker source documents when you generate output.

Version used for generation 

Specifies the version of Adobe FrameMaker to use when generating output. Use this setting if you have more than one version of Adobe FrameMaker installed on the computer used to generate output and you want ePublisher to use a specific version of Adobe FrameMaker when generating output.

Documents per Word session 

Specifies how many Microsoft Word document conversions one Word session handles before ePublisher restarts Microsoft Word. ePublisher runs Microsoft Word hidden to apply the project's settings to Word documents, and each start of Word takes several seconds, especially with Microsoft 365 Word. The default is 10. A document that is also converted for PDF output counts twice.

Set this value to 1 to restart Microsoft Word for every conversion, as earlier versions did. Do so if a document makes Word unstable and later documents in the same generation are affected, or to compare output with an earlier version. A larger value saves a little more time when a project has many small documents. Whatever the value, ePublisher also restarts Word before it retries a conversion, after a conversion that failed, was stopped, or needed a retry, and whenever Word is no longer running.

Changing this value does not cause documents to be converted again. A value that is not a whole number of 1 or more is reported as a warning in the generation log, and 10 is used instead. PAGE and NUMPAGES fields in the body text of a document can show different numbers than in earlier versions; these fields never showed the printed page numbers in online output, and a later release is planned to make them consistent.

Preserve change bars in PDF 

This allows the change bar feature in Microsoft Word to be added to the PDF output.

Preserve Index 

By default, ePublisher does not use the Index generated within Microsoft Word. In cases (usually when generating PDFs) where you want to preserve the Index generated by Microsoft Word, you can enable this feature.

Preserve Table of Contents 

By default, ePublisher does not use the table of contents generated within Microsoft Word. In cases (usually when generating PDFs) where you want to preserve the table of contents generated by Microsoft Word, you can enable this feature.

Preserve Table of Figures 

By default, ePublisher does not use the table of figures generated within Microsoft Word. In cases (usually when generating PDFs) where you want to preserve the table of figures generated by Microsoft Word, you can enable this feature.

RD field behavior 

Specifies how you want Referenced Document (RD) field code behavior used when you generate output using Microsoft Word source documents that contain RD field codes that reference other source documents. The values for this setting are defined as follows:

Value

Description

Indicates Book document

Processes source documents that contain RD field codes as book files. ePublisher processes all the source documents identified by RD field codes.

Ignore

Ignores all the source documents identified by RD field codes. ePublisher processes only the source documents included directly in the project.

Auto-Detect

Processes source documents that contain RD field codes based on the contents of the source document. ePublisher analyzes the contents of each source document to determine if the file should be processed as a book file, front matter, table of contents, or index. This analysis is based on the presence of RD field codes combined with the presence or absence of a TOC or INDEX field code, which indicate whether the document contains a table of contents, index, or table of figures..

Update external references 

Specifies whether ePublisher refreshes the fields, linked pictures, and linked objects in Microsoft Word documents that refer to other files or websites when it converts the documents, and whether it opens a document's attached template. This setting is off by default. Either way, ePublisher works on its own copy of each document; your source documents are never changed.

Fields and linked objects. When this setting is off, ePublisher converts fields and linked objects that refer to other files or websites from the results stored in the document, the last version its author saw, and never asks Microsoft Word to fetch them, so Word does not show its field security notice during a conversion. Included text (INCLUDETEXT fields) is the text as last updated in the document, not the current content of the included file. Included pictures (INCLUDEPICTURE fields) and links to data in other applications (linked objects and LINK, DDE, and DATABASE fields) keep the results stored in the document.

Linked pictures. When this setting is off, a picture that is stored in the document and also linked (Insert and Link) is converted from its stored copy when its link is to a website, a network share, or a file that no longer exists. When its link is to a local file that exists, the picture comes from that file, as in earlier versions. A picture that is linked without being stored (Link to File) is not included in the output when it is on a website or when its file does not exist, and the generation log names the document and the picture. To include such a picture, store it in the document or correct the link in Microsoft Word.

Attached template. When this setting is off, ePublisher opens a document's attached template (Developer > Document Template) only when the template is a file on a local drive that exists. For a template on a website, SharePoint, a network share, or a mapped network drive, the output uses the styles stored in the document, and the generation log names the document and the template. That message is a warning when the document has Automatically update document styles turned on: Microsoft Word restyles such a document from its template when it opens it, so the output can differ from what Word shows. A Word 97-2003 (.doc) document keeps its template.

When the setting is on. ePublisher refreshes these fields, pictures, and objects from their sources and keeps the attached template, as earlier versions did. Included text, included pictures, and linked pictures are refreshed only when Microsoft Word is set to update them without asking: the Word value DisableWarningOnIncludeFieldsUpdate must be 1, and a value set by Group Policy takes precedence over the user's own. Otherwise ePublisher uses the results stored in the document and logs a warning that names the document, because ePublisher runs Word hidden and nobody can answer the field security notice. Turn this setting on only for projects whose output depends on refreshing these references at generation time, such as shared text maintained in included files, and where your IT team allows the Word value. For how to set the Word value, see Word Dialogs During Conversions and the Field Security Notice in the ePublisher Silent Installation Guide.

Mail merge. Whatever this setting, ePublisher converts a mail-merge main document without connecting to its data source, and the generation log says so.

All DITA topics must exist 

Specifies whether or not to generate an error instead of a warning whenever a missing topic is found during the processing of a ditamap.

Combine DITA character styles 

Starting with version 2014.1, ePublisher will use combined character styles to allow nested elements to be styled more precisely in the generated output. For new projects this setting will default to enabled, otherwise it will be disabled for backward compatibility.

Convert notes to tables 

Enable this setting to convert DITA <note> elements into simple tables with ePublisher paragraph styles for better control of the generated output.

DITA Abbreviated Form Scope 

Specifies what scope to use when controlling when an abbreviation should be used instead of the long form. The values for this setting are defined as follows:

Value

Description

Map

Use the long form once for the entire ditamap. All other instances after the first usage will use the abbreviated form.

Part

If you organize multiple chapters into a part, then only the first instance will use the long form within the part.

Chapter

Use the long form once per chapter.

Topic

Use the long form once per topic.This is the default configuration.

DITA Open Toolkit version 

Specifies the version of the DITA Open Toolkit you want to use when generating output using DITA source documents.

Emit draft comments 

Enable this setting when working with DITA and you want to emit draft comments.

Ignore print attribute 

Disable this setting if you want ePublisher to process the print attribute for DITA content. In the DITA 1.3 specification, the@print attribute was deprecated and a new attribute that obeys DITA filtering rules, @deliveryTarget, was introduced.

Last modified date: 11/05/2026