Overview
Comala Publishing for Confluence Cloud is a separate app that publishes 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
In the Comala Publishing dashboard
choose Configure Publishing to open the space publishing configuration wizard to enable Comala Publishing in the space
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.
select the target space for publishing from the dropdown menu
choose Next
The named target space that the current space (the source space) will publish to is confirmed in the Configure Publishing dialog box.
The Publish the Source Space option publishes all the pages in the space to the added target space.
choose this button to open a confirmation dialog box
choose Publish to publish all the pages in the space to the target space
A progress bar displays the publishing progress. On completion, a report is displayed for the whole space publish action.
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
use the single-page publishing to add a Publish button to each page in the source space, allowing your editors to publish each page 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 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 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.
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.
Related Links
- Standalone publishing
- Single page publishing
- Publishing using a Comala workflow
- Publishing report
- Space publishing