Documentation Center

Configuring LiveContent publishing settings

You can configure LiveContent publishing settings by editing the PublishConfiguration.xml file.

About this task

The following are some of the ways you can configure LiveContent S1000D publishing settings you can specify in the PublishConfiguration.xml file:
  • The directories on the Contenta Web server where LiveContent S1000D templates and published IETPs are stored
  • The amount of Java memory when publishing large publications (for instance, to increase memory for publications containing thousands of data modules)
  • How LiveContent S1000D displays search results
  • Whether content references are resolved before data is sent to LiveContent S1000D
  • Whether content references are resolved before data is sent to LiveContent S1000D
  • How large tables are segmented
  • Whether to use a custom ExtraConfig file
  • Whether to use a custom FrontMatter XSL file

Procedure

  1. As an administrator user on the Contenta Web server, navigate to the Contenta_home/web/cw_common/custom/S1000D_Publish directory and open your publish configuration file in an XML or text editor.
  2. Locate the following line, and change the value to the path where the LiveContent S1000D skins are located:
    <property name="PresentationLayer" value="C:/Program
    				  Files/XyEnterprise/ContentaView/templates"/>
    Always use forward slashes in the path, regardless of the platform where the output is stored.
  3. Locate the following line, and change the value to the path where you want the IETPs to be stored:
    <property name="DataDir" value="C:/Program
    				  Files/XyEnterprise/ContentaView/"/>

    Always use forward slashes in the path, regardless of the platform where the output is stored. For Unix systems, ensure that the directory has no spaces (both on the system and in the PublishConfiguration.xml file).

  4. Locate the following line and increase the value as needed depending on the sizes of your publications and the capacity/resources of your Contenta Web server.
    <property name="Java_Xmx" value="1024m"/>
  5. To configure S1000D Publish to paginate LiveContent S1000D search results, refer to Paginating search results in a published IETM.
  6. To configure S1000D Publish to resolve content references before sending data to LiveContent S1000D , add the following line to set the value for the LiveContent_PublishTool_ContentRefResolve property to true:
    <property name="LiveContent_PublishTool_ContentRefResolve" value="true"/>
  7. To configure LiveContent S1000D to exclude the source XML from the published IETP, set the value for LiveContent_IncludeSourceXmlInIetmDeliverable to false:
    <property name="LiveContent_IncludeSourceXmlInIetmDeliverable" value="false"/>

    The default value for this setting is true.

  8. If the content being published contains one or more large tables, configure how they are segmented by finding the following lines and modify them as required.
    <property name="LiveContent_hugeTableLowerLimit" value=""/>
    <property name="LiveContent_hugeTableSelectionSize" value=""/>
    where the value for LiveContent_hugeTableLowerLimit is the minimum number of rows in tables to be segmented and LiveContent_hugeTableSelectionSize is the number of rows in each table segment.

    For more information about these properties, refer to the Publishing section of the LiveContent S1000D Implementation documentation.

  9. Optional. To use a custom ExtraConfig file, find the following line and change the path to specify the desired custom file:
    <property name="LiveContent_ExtraConfig" value="[contenta_view_install_dir]/templates/conf/system/s1000d.xml"/>
  10. Optional. To use a custom FrontMatter XSL file, find the following line and change the path to specify the desired custom file:
    <property name="LiveContent_FrontMatter" value="[contenta_root_dir]/encaps/S1000D/LiveContent_FrontMatter.xsl"/>
  11. Save and exit the publish configuration file. If you have multiple publish configuration files, modify the other files as needed.