Different-space publishing

Overview

Different-space publishing allows you to edit draft content in one space, and then publish it to another space on the same server.

The Comala Publishing app must be installed to enable different-space publishing.

Activating different-space publishing

There are two steps to setting up different-space publishing:

Configure the Comala Publishing app to connect the draft and public spaces – see also: How Comala Publishing works
Update your workflow to trigger the publishing process (see below)

Workflow markup

The publishing is triggered by an action macro, {publish-page}, which must be used in a {trigger}.

{workflow:name=Different-space Publishing}
   {state:Editing|submit=Review}
   {state}
   {state:Review|approved=Published|rejected=Editing}
      {approval:Review|assignable=true}
   {state}
   {state:Published|final=true|updated=Editing}
   {state}
   {trigger:statechanged|state=Published}
      {publish-page}
   {trigger}
{workflow}

The example markup above is based on the example from same-space publishing, but we've added the trigger at the bottom.

When the state changes to Published, the trigger is activated and the publish-page macro instructs the Comala Publishing app to synchronize the published content with the other target space.

For different-space publishing all the work is done by the publish-page macro. The publish-page macro can be used to publish the content from any state using an appropriate trigger event.

In the example, we have simply chosen to publish the draft space Published state content when the workflow changes to this state.

Space publishing and the latest approved workflow final state version

The Comala Publishing app can also be configured to only publish the latest approved workflow final state version when a space administrator publishes the whole space using the space publishing dashboard Publish option.

The Use final state version space publishing option can be set together with an applied workflow with a publish-page action macro trigger to publish a document on transition to the final workflow state.

Macros

Page:

pdf-export macro — export content as a pdf
Page:

publish-page macro — Publish content to a different space
Page:

snapshot-page macro — Create a static versioned snapshot of a document

Examples

Page:

Advanced different-space publishing

Comala Document Management for Data Center