Snapshot document publishing

Overview

Snapshot publishing allows you create static versioned documents from your dynamic Confluence content,
freezing content from Confluence macros that display live content in a snapshot document. A snapshot of a Confluence document can be created using a workflow trigger.

Once a snapshot is created, it can be organized and managed in one or more themed groupings of snapshot documents - called collections - to create manuals, static records for audit.  View permissions for each collection can be added outside space permissions.

A global collections viewer in the Confluence header allows users to view snapshots in PDF or HTML format.

The Comala Publishing (Snapshot Publishing) app v3.0+ must be installed to enable snapshot publishing.

Activating snapshot publishing

There are two steps to setting up snapshot publishing:

1. Configure the Comala Publishing app to enable snapshot publishing in a space

2. Set up Comala Snapshot Publishing in a space

3. Update your workflow to trigger the snapshot publishing process (see below)

Workflow markup

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

{workflow:name=Snapshot 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}
      {snapshot-page|collection=@collectionname@|contributor=@lastapprover@}
   {trigger}
{workflow}

The example markup above 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 snapshot-page macro instructs the Comala Publishing app to create a snapshot document from the Confluence document.

Macros

• Page:
  pdf-export macro — export content as a pdf 
• Page:
  snapshot-page macro — Create a static versioned snapshot of a document

Examples

See also

• Same-space publishing

• Different-space publishing

• Remote-space publishing

Comala Publishing

• Snapshot Publishing

• Snapshot Collection