A new version of cloud publishing is now available with a change to the PDF Generator Preview feature.

Cloud Publishing 26.08.21

Cloud publishing is an umbrella term for the cloud-hosted infrastructure that spins up temporary resources to process publishing and deployment jobs on content managed in Heretto CCMS. This includes PDF Generator and DITA-OT Cloud publishing jobs. It also processes deployments, both manual and active sync, for Heretto Deploy API and Heretto Portal.

New versions of cloud publishing are released independently of Heretto CCMS, Heretto Deploy API, and Heretto Portal, and are deployed to customers immediately after release.

• Changed. We changed how the PDF Generator Preview feature handles a topic whose root element is completely filtered out by a DITAVAL condition. For example, when an audience attribute is set directly on the topic root element rather than on the related topicref element in the map. Previously, this combination could cause preview generation to fail. Now, Preview tolerates a fully excluded topic and completes without failing.

  Important:

  Applying a filtering condition to a topic root element is not a valid DITA structure and should be avoided. Excluding an entire topic this way causes two critical issues:

  • Leaves behind an XML file with no root element, which is invalid

  • Leaves behind a map with a topicref element that points to a resource that doesn't exist, because it was filtered out

  Both of these will still cause failures when publishing content with PDF Generator, DITA-OT, and other tools.

  When excluding an entire topic from a deliverable, always apply filtering conditions to the topicref element in the map, not to the topic itself.

  <concept audience="audience-a">
    <title>(...)</title>
    <shortdesc>(...)</shortdesc>
    <conbody>
      <p>(...)</p>
    </conbody>
  </concept>

  <map>
      <title>(...)</title>
      <topicref href="concept-audience-a.dita" audience="audience-a"/>
  </map>