Export content from the DITA CMS

You can export content from the DITA CMS to another location to, for example, send your DITA source to a customer or external user, or to build output using a standalone DITA Open Toolkit as a troubleshooting measure.

Important: IXIASOFT does not recommend exporting content from the DITA CMS with the intention of performing external edits and re-importing. While the DITA CMS does support this from a functional standpoint, you run the risk of losing revision history and potentially overwriting any changes that occurred within the CMS after the content was exported. The re-import is an overwrite, not a merge.
  1. Locate the map, topic, or image you want to export.

    When you export a map, the export includes all the map's references: sub-maps, topics, images, and topics referenced via xref, conref, keyref, etc. Likewise, when you export a topic, the export includes all of the topic's references.

  2. Right-click the object you're exporting and select Generate Output.
  3. In the Output Format drop-down, select the Export output type.

    If this option is not available, ask your CMS Administrator to check the system configuration to ensure that you are assigned to a role that has access to Export and that the output type is enabled.

  4. Select other options as appropriate and click Create.

    It is not currently possible to apply a ditaval to exported content. The Export process simply gathers the required content from the Content Store and returns it to you. The DITA Open Toolkit is not involved in the Export and therefore there is no opportunity to perform any transformation on the content.

  5. Select the location to save the zip file of exported content.
Within the zip file, the exported content is in the content\authoring subfolder. This subfolder contains a number of items other than the content itself. For each exported object, the following files are provided:
  • *.properties
  • *.customproperties
  • *.indexedcontent
While you can use information in these files for different purposes, neither you nor a third party needs them to generate basic output. You can delete them if you choose.
Important: If you are sending the content to a third party to generate their own output, you must also send the following plugins from the Output Generator:
  • com.ixiasoft.dita.dtd
  • org.oasis-open.dita.mathml.doctypes
  • com.ixiasoft.images
  • org.w3c.mathml3