Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Insert excerpt
Comala Publishing - assets
Comala Publishing - assets
namecp_logo
nopaneltrue

Table of Contents
maxLevelminLevel2
minLevelmaxLevel23
absoluteUrloutlinetruefalse
excludeSee also
typeflat
separatorpipe

...

printabletrue

Getting started

Comala Publishing for Confluence Cloud is a separate app that publishes Cloud publishes and syncs pages between spaces in the same Confluence site - from a source(draft) space to a target (published) space.

...

Comala Publishing is used to publish your draft pages from one space to another space in the same Confluence site

Each publishing action copies each page's content from the source (draft) space to the target (public) space, maintaining the page hierarchy where possible.

To publish pages, a user must have view and edit permissions on the draft source space and the public target space pages.

Enable Comala Publishing for a space

Publishing must be enabled and configured for a space using the space tools App links to the Comala Publishing dashboard in the source (draft) space.

...

Publishing set up wizard

Filter by label (Content by label)
showLabelsfalse
max1
maxCheckboxfalse
showSpacefalse
reversefalse
cqllabel = "cp_spaceadmin" and space = currentSpace ( )

In the Comala Publishing dashboard

Info

The publishing setup tool is only available if the space is being set up for the first time or any publishing configuration has been cleared using the Clear Publishing Configuration option.

...

Publishing dashboard

When a target space is selected and saved in the publishing dashboard, and publishing is enabled, the app can publish a page from the current space to a target (public) space.

...

After adding the target space, you can use single-page and space publishing to move pages from this space to the target space.

The space administrator can configure the publishing settings for the space. You can:

...

prevent the copying of page content properties if there is a 3rd party app in the target space

...

A space administrator must enable publishing from a source space to a target space and have Confluence permissions for both spaces.

After the space is set up for publishing, a space administrator can publish all pages at once and configure the publishing settings to grant or deny permission for page editors to publish on a page-by-page basis.

The Publish space button publishes and syncs all the current space pages to the target space

Publishing permissions

To configure publishing

  • you must be a space administrator in the source and target space

To publish all the pages in a space, in the source space and target space

  • a space administrator requires view and edit permission for all the pages

  • a user publishing an individual page needs view and edit permission

You also need the following space permissions in the target space to publish:

  • View All

  • Add and Delete Pages

  • Add and Delete Attachments

Page-level restrictions on a page in the target space prevent a space administrator from publishing and syncing the source space page. As a space administrator, if you publish all the pages, a restricted page is not included in the list of 'Pages not published' in the whole space publishing report.

Two ways of publishing your pages

Once a space is configured for publishing, you can publish and sync pages using single-page publishing and space publishing to publish all the pages in a space.

Single-page publishing

A user can publish each page manually Both editors and space administrators can track the page sync status using the publishing report, which is accessed from the source space.

Enable publishing in a space

The space administrator can configure and enable publishing in a space using the setup tool in the publishing dashboard.

...

Publishing settings and permissions

After enabling the space for publishing by adding a target space, the space administrator can use the dashboard to manage what is copied for a page and how pages can be published.

...

The space adminsitrator also needs to ensure that publishing editors and themselves have Confluence permissions in both the source space and the target space.

Publishing pages

There are two ways to publish pages using the app on its own:

Single-page publishing

Page editors can publish single pages using the publishing byline to open the publishing popup.

...

...

select Publish

...

Successful publishing of the page is confirmed

  • in the publishing status byline and the addition of a link to the published page in the popup

...

  • in an on-screen message

...

The space administrator can disable single-page publishing for a space. This can be useful if you want to limit publishing to the space administrator or manage your documentation and publishing together with an applied Comala workflow.

Space publishing

A space administrator can publish all the content from a source space to a target Space publishing

Space adminstrators can publish all the pages in a space in a single publishing action using the Publish space option in the space settings publishing dashboard.

...

A progress bar displays the space publishing action progress.

...

The dashboard confirms successful publishing, including the date, time, and user who actioned space publishing.

...

If the space publish action cannot publish all the source pages, details of the unsuccessful pages are displayed.

...

If the space has no pages (except the home page), space publishing cannot occur and is confirmed in an on-screen notification.

...

When using the Publish space option in the space settings publishing dashboard, a publishing progress bar is displayed for the space.

...

On each published page in the source space, a Page published confirmation message is displayed when viewing the page.

...

What is copied from a source space page when publishing?

Publishing and syncing a page maintains the page hierarchy where possible, although the order of the content is not necessarily maintained in some circumstances.

When the hierarchy is not maintained in a publish action, the page is published to the root of the destination space.

Each published page includes

  • the content title

  • the content body

  • attachments

  • content properties*

  • content labels

The Comala Publishing status is copied but is not visible on the content for users with view-only permission.

When publishing, /wiki/spaces/CPCL/pages/1286602822 to local pages in the source space are replaced with the links for the page in the target space.

Exceptions to this are:

  • when the URL used is a short URL

  • the link is to a heading or anchor in a different page in the source space

When publishing an updated page that has already been published, Comala Publishing deletes it and copies the updated page as a new page in the target space and the Confluence page version in the target space is v1.

What is not published or copied?

Comala Publishing Cloud does not support publishing

  • the home page of a space

  • blog posts.

  • custom content properties for apps

  • the source space Confluence version

The following is also not published from the source space

  • inline comments

  • page-level permissions

  • comments

  • archived pages

Content properties are copied by default when publishing a page. In the space settings publishing dashboard, this can be disabled for a space.

...

Comala Publishing also works with our Comala Document Management family of apps using an added Comala workflow. Adding automated workflows to your pages and spaces helps you better manage the document lifecycle, allowing audiences to see published pages upon approval automatically.

After publishing is configured for a space, you can track what pages and spaces are in sync using the publishing report.

...

The space administrator can also publish pages directly from the report.

Get started

Child pages (Children Display)
allChildrentrue