Excerpt
hidden true
Image Removed Image Added

Image Removed

Image Added

Quick Start with Comala Publishing

Overview

Comala Publishing can be is used for

• between-space publishing and lets letting you keep two spaces in the same instance in sync

• copying in a one-time copy operation any space content to a target space within the same instance

• the creation of a static versioned snapshot document documents from your dynamic Confluence content and the organization of these documents as logical groups in one or more collections

Getting Started

You will need global administrator permission to Install the app from the Atlassian Marketplace.

Once installed, you will then need to set the global configuration for the app to define

• the global user permissions for the app

• the spaces in which the app can be used

  • to publish and copy

  • for snapshot publishing

• the content properties that can be are published including the content label that can be used by the space admin to sync content

Secondly, a space administrator configures

• the link between the space for the content to be published (target space) and the space for the draft content (source space)

• the target space for a one-off copy of the space

• the content and properties to be published or copied e.g. pages, blog post posts or both, and how they are published

• a whether the space to can use snapshot publishing

Comala Publishing users

Global Configuration

A global administrator will need to configure

• the permissions for the user group who can publish and copy the content

  • Publishers Group - users who can configure a space for publishing and publish content must be a member of the added Confluence user group

  • Copiers Group - users who can copy must be a member of the added Confluence user group

Image Removed

Image Added

• the permissions for the user group who can snapshot publish and create a collection

  • Collection Managers group - users who can set up a space for snapshot publishing and create a collection must be a member of the added Confluence user group

Image Removed

Image Added

If required, set the spaces that can be published

• separate configuration setting for publishing/copying and snapshot publishing

• the default is ANY space in the instance for each setting

You can limit the spaces for each publishing feature by adding one or more spacekeys

Global admins can also

• set the prefixes for content properties such as metadata to be published or copied

  • the default prefixes are metadata and com.communardo

• set the label that space admins can optionally use to ignore or publish space content

  • the default label value is syncme.

Space Publishing Configuration

A space admin will need needs to

• link the draft and published spaces

• configure the type of content and content properties to be published

• set the options for publishing content e.g. allow single page publishing, publish content with the sync label set by global admin

The user must also be a member of the Confluence group added to the app global configurationPublishers Group.

Link the draft and published spaces

As the space administrator youadministrator, you must link your draft and published spaces.

Image Removed

Image Added

You can choose to

• set the current space as the published space and link to a draft space

• set the current space as draft space and link to a published space

Choose a space to be the linked space in the dropdown menu. 

Image Removed

Image Added

Once the spaces are linked you can

• Configure the content to be published

• View Changes that will be made when space is published

Image Added

Image Removed

Configure the space publishing options for content

In the publishing screen you can , Configure what to include when you publish your draft space content.

You can set Set publishing options including

• link/change the target linked space using the dropdown menu

• enabling users to publish single pages using the Single Page Publish slider

• excluding pages or blog posts from the publish action

• cleaning up of  out-of-sync pages

• keeping labels intact

For publishing actions, you can use check buttons to configure the content to be published

• Page Content Options

  • use and configure the use of the globally set label to determine the space content to publish

  • enable/disable copying of page properties

  • include/exclude labels

  • copy page restrictions

  • version comments

  • override content in the selected target space (and do not retain page history)

  • when publishing use the modification date or publishing date in the target space

• Display Visualization Options

  • display publishing status lozenge

  • display draft watermark on draft space logo

• Space Publishing Options options Sync Conditionswhen publishing from the space tools dashboard include

  • publish pages, blog posts, or space home page and any orphan pages in the draft space

  • delete content in the published space that is not in the draft space

  • only publish changed draft space content when publishing a whole space

  • always publish content even if there are no updates in the draft space

  • only publish content in a Comala workflow final state (when a Comala Document Management family app is applied) and publishing content on transition to the workflow final state

  • use of a sync label to filter the publishing of content

When Display Publishing Lozenge is checked a publishing status lozenge is added to the content to easily identify the state of each draft and published page.

0Image RemovedImage Added

The publishing status lozenges will be are one of

• Status
  colour Blue title new

   

  • NEW content not yet published 

• Status
  colour Yellow title out of sync

   

  • OUT OF SYNC previously published  content is now different in each space

• Status
  colour Green title published

   

  • PUBLISHED is published content that is the same in each space

Publishing content

You can make content changes in your draft source space, and then update the publish target space pages all at once or one page at a time.

Choose the Publish button to publish the whole space content.

Image Added

0Image Removed

The last whole space publish synchronisation is displayed

Details of the pages publishing status are displayed in the View changes option in the space tools Publishing dashboard.

Viewing out of sync content

The View Changes option button will display displays any content that is out of synchronization between the draft source space and the published target space.

Image RemovedImage Added

Filter buttons allow you to choose the date range for out of sync content, publishing status of content, and the user who last updated the content.

Checking content sync

If content is not shown as expected check

these

the filters.

Toggle between the target and published space to view the content in that space that is out of sync.

The report will list lists new or edited content since the last Publish action within the set date filters.

choose either the draft or published space to view the content in that space that is not synchronized

.

Here the Published Space has content that is not in the Draft Space.0

Image RemovedImage Added

The report will list lists new or edited content since the last Publish action.

some

Some content may also be listed due to the publishing configuration e.g. NOT IN DRAFT changes lozenge in the published space may be due to the checked configuration setting Ignore all the top level pages.

 If you publish a page whose parent does not exist in the target space, it becomes an orphan in the target published space (published to the root of the space).

Info
Comala Publishing is not designed to publish a page that is the child of the Draft Space homepage to be a child of different named homepage in the Published Space.

Tip
When first publishing a space configuring publishing to delete content added in the published space will remove the published space home page and replace it with a copy of the draft space home page and set this page as the published space home page.

Space Publishing - useful pages

Filter by label (Content by label)
showLabels false max 6 showSpace false cql label = "sp_guide" and space = currentSpace ( )

---

Copy a space

With Comala Publishing, you can alsocopy one space to another to replicate content. Use this Copy Space option to copy a space as it exists at a point in time.

Image RemovedImage Added

The Copy options

• target space is configured separately to from the publishing target space

• settings for content to be copied are set separately to from the publishing settings

To copy a space, users must be a member of the Confluence group added to the app global configuration Copiers Group.

Copy Space - useful pages

Filter by label (Content by label)
showLabels false showSpace false cql label = "copy_guide" and space = currentSpace ( )

---

Snapshot Publishing space configuration

A space admin will need needs to

• set up/enable the space for snapshot publishing

Once snapshot publishing is enabled in the space the space admin as a collection manager can

• create one or more collections in the space

• add user view and add user contributor permissions for each collection

• link collections to the space created by other collection managers

Only a user who has space admin permission and is a member of the global Collection Managers group can set up a snapshot publishing in a space.

Collections and the added snapshot documents can be viewed in the collections global viewer by any user with view permission or contributor permission for the collection irrespective of the user permissions on the source Confluence document.

A snapshots of a Confluence document in a space can be added to one or more collections by a user who has contributor permission for each collection and the collection is linked or created in a space.

Snapshot Publishing - useful pages

Filter by label (Content by label)
showLabels false max 6 showSpace false cql label = "snap_guide" and space = currentSpace ( )

---

Publishing content using a Comala workflow

If the Comala Document Management Family of Apps Mapapp is installed together with Comala Publishing and a workflow is applied to a page or blog post, the space administrator can also choose to configure

• the space publishing of content a whole space that is only in the workflow final state/publish content on a workflow transition to the last approved versionthe publishing of content only publishes the latest approved version (the version created on the last transition to the workflow final state)

• publishing a single document using a workflow trigger with the publish-page macro action macro

• the snapshot publishing of a document using a workflow trigger using the snapshot-page macro or pdf-export macro action macros

Tip
When a Comala workflow is applied, publishing of a single page or blog post also occurs on the transition to the applied workflow final state (the latest approved version).

Publishing with a Comala workflow - useful pages

Filter by label (Content by label)
showLabels false showSpace false cql label = "comala_wf" and space = currentSpace ( )

Comala Publishing can also be used to publish on the transition to the final state of a Comala Document Control app workflow or the Comala Document Approval app workflow.

---