Documentation Center

Publishing interface customization

You can customize the Contenta S1000D Publish interface by adding, removing, or modifying options in the publish configuration XML files. You can also customize the Publish applicability interface by using optional applicability markup that was introduced in Issue 4.1.

Publish configuration files

Publish configuration files are located in the Contenta home/web/cw_common/custom/S1000D_Publish directory on the Contenta Web server. Publish configuration files contain both hidden and displayed options for publishing to LiveContent or to PDF.

If you upgrade to a new version of Contenta, new versions of the PublishConfiguration.xml and the PublishConfiguration_Unix.xml files are delivered to a distr location so that existing files are not overwritten.

Publish configuration options

Publish options with fixed values (for example, the path where LiveContent skins are located) are typically set by an administrator and hidden in the S1000D Publish interface. Hidden options are in <property> tags in publish configuration files.

Publish options with variable values (for example, the publications and output formats that a user wants to publish) are displayed in the S1000D Publish interface. Visible options are in <group> tag hierarchies in publish configuration files. Option types include CHECKBOX, ENTRY, MULTISELECT, MULTISELECT_QUERY, and SINGLESELECT.

Applicability interface options

The S1000D Publish tool supports optional Issue 4.1 or higher applicability markup for primary product identifiers, prompts, and enumeration labels. When present, this markup is displayed in the Publication Module Applicability window that opens when an author clicks Set Applicability and selects a PM. Specifically, the applicability window displays the following:
  • Primary product identifiers: In Issue 4.1 or higher ACT DMs, the Publish tool looks for the optional productIdentifier attribute in each <productAttribute> tag in the ACT DM. If found and set to primary, only these <product> id values are used to populate the BY PRODUCT table in the Publication Module Applicability window; that is, only products that contain a primary product identifier as the <assign> tag's applicPropertyIdent attribute value in the PCT DM are displayed in the BY PRODUCT table. Otherwise, the product id attribute values are used to populate this table; in this case, there is no way to know which product identifiers are primary.
  • Prompts: In Issue 4.1 or higher ACT/CCT DMs, the Publish tool looks for the optional <prompt> tag in each <productAttribute> tag in the ACT DM and in each <cond> tag in the CCT DM. If found, the <prompt> tag contents are displayed in the left-hand columns of the BY ACT and BY CCT tables respectively in the Publication Module Applicability window. Otherwise, the product attribute and condition <name> tag contents are displayed.
  • Enumeration labels: In Issue 4.1 or higher ACT/CCT DMs, the Publish tool looks for an optional enumerationLabel attribute in each <enumeration> tag in both ACT and CCM DMs. If found, the enumerationLabel attribute values are displayed in the right-hand columns in the BY ACT and BY CCT tables in the Publication Module Applicability window. Otherwise, when there are no enumerationLabel attributes, or when an enumerationLabel attribute has been incorrectly added to a list or range of applicPropertyValues such as Mk1|Mk9 or 1~3, the applicPropertyValues themselves are displayed.