Documentation Center

Publishing an IETP

You can publish an IETP for use with Contenta S1000D or your own IETP viewer.

Before you begin

RWS LiveContent must be installed and configured if publishing to LiveContent S1000D . If publishing to the file system, you must perform additional setup (see "Configuring third-party output formats").

About this task

When you publish an IETP, you select the publication modules, applicability, LiveContent skin (if publishing to LiveContent S1000D ), and other options. The publishing options that are available in your publishing configuration may vary.

Procedure

  1. In Contenta S1000D, select the desired Configuration, Project, or PModule object.
  2. Select Tools, then select S1000D Publish.
  3. Select one or more PMs to publish.
  4. If any of the selected PMs has applicability, and you want to filter by applicability during publish rather than while viewing the IETP, perform the following steps:
    1. Select Set Applicability.
      The Publication Module Applicability window opens.
    2. Select a PM.
    3. Indicate the content that you want to be rendered.
      Unless a check box is selected or a text field contains a valid value, the content with that applicability will not be included in the IETP.
    4. Select Apply Applicability.
      The applicability that you select here applies until you close the browser.
  5. To publish an incremental update to an existing IETP:
    1. Select Select Change Package. If one or more change packages exist for the PM, the Select Change Package window appears.
    2. In the Select Change Package window, complete the fields as described in the following table.
      FieldEntry
      Optimize publish forSelect either the Size or Speed radio button to optimize the publish for size or speed.
      Select a change package to publishSelect a change package from the drop-down list.
    3. Select Apply. Your selections are saved and the system displays a confirmation message showing your selections.
    4. Select Close to close the Select Change Package window.
  6. In the Formats field, select LiveContent or select Contenta to name-of-your-IETP-viewer.
  7. Select the Resolve Explicit CIR References check box to resolve explicit references to CIR items, which are available in S1000D Issue 4.1 and later. Clear this check box (which is selected by default) if your publication does not include CIRs or if you don't need to resolve CIRs during this publish.
    Resolving CIR references in a larger publication can slow down the publish process.
  8. Select Resolve Implicit CIR References to resolve implicit references to CIR items.
    This option becomes available only if Resolve Explicit CIR References has been selected.
  9. Select the Get Latest Content check box to obtain the latest versions of reusable components (warnings, cautions, support equipment, supplies, spares) from the CSDB repository. Clear this check box (which is selected by default) to output the versions of reusable components in each data module, which may not be the latest versions, or if your site is not using the Contenta S1000D reusable components functionality, that is, not storing reusable components in the CSDB repository.
  10. LiveContent only:
    1. Enter a unique ZIP File Name.
    2. Enter a Collection Name.
    3. Select a Skin Name (presentation template) for the IETP.
      Contenta S1000D delivers a Carbon skin by default. You may supply your own skin if preferred.
    4. Select ToC Title Display to specify the Table of Contents title display for the IETP to be one of three options: TechName and InfoName, InfoName Only or TechName Only.
    5. Select Encoding of API Results to specify the character encoding for content generated by the LiveContent S1000D API.
    6. Select Create Mobile Content to include content for display using LiveContent S1000D Mobile in the published output.
    7. Select Encrypt Figures to to secure assets (illustrations or other media types) across all publications in the IETP
    8. To download the LiveContent .zip file, select the Show Link to ZIP File in Log check box.
      If you do not select the check box, the .zip file is stored on the Contenta Web server.
    9. Select the Upload Completed ZIP to CSDB check box to upload a copy of the .zip file to the Deliverables folder in Contenta.
      This option does not apply if you published from a project.
    10. Select the Flash Front Matter in ZIP File check box to include SWF files for the front matter in the IETP.
    11. To delete the collection from the server once the IETP is published, select the Delete Content from ZIP File check box.
      If the collection is not cleaned, subsequent publish activities to the same collection name appends content to the collection. Users are able see each others' publications.
  11. Select Publish.
    While publish is running, progress messages are displayed in the Publish window.
  12. After Publish completes, select View Log, then scroll to the bottom of the publish log.
  13. If you are publishing an incremental update, open the zip file of most recent full publish, start LiveContent, select the Install Updates link, and browse to the change package zip file to install the updates.
  14. If Publish completed with errors or warnings, scroll through the publish log to find the errors or warnings, which are highlighted (yellow background). For example, Publish warns about missing or invalid WCN targets:

    [REF RESOLVE] Referenced WCN is in Data Module: NOTEXIST-AAA-D00-00-00-00AA-041A-A

    [WARNING] Missing target for referenced caution

    [REF RESOLVE] Referenced WCN is in Data Module: NOTWCN-AAA-D00-00-00-00AA-042A-A

    [WARNING] Invalid target for referenced caution

Example