Get started - Publishing pages
- Robert Alexander Marshall
- Comala Publishing for Confluence Cloud
Publishing your pages
After a space administrator configures a space publishing space in the space publishing dashboard, you can publish and sync pages from the source space to the target space using single-page publishing and space publishing.
When publishing a space for the first time, it is recommended that you publish all your pages using the setup wizard. This helps establish the page hierarchy in your target space.
Single-page publishing
An editor user can publish each page manually using the publishing byline to open the publishing popup.
select Publish
The publishing status byline confirms the page's successful publishing and a link to the published page is added to the popup.
Successful publishing also displays an on-screen message with a link to the published page in the target space.
You can use the Refresh page option to display the updated publishing status byline.
The space administrator can prevent single-page publishing in a space, limiting publishing to the space administrator or publication of your documentation with an applied Comala workflow.
Space publishing
A space administrator can publish all the content from a source 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 does not have pages (except the home page), space publishing cannot occur, and this 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.
The publishing report includes an option for the space administrator to publish pages. In it, you can view the publishing status of your pages and publish and sync them directly from the report.
Publishing report
The publishing report allows editors and space administrators in a source space to view the publishing state (the synchronization state) of all the pages in the source space and the pages in the target space.
You can apply a report filter based on the page publishing status (state NOT SYNCED or ANY STATE filter) or by the final state of the workflow (if a Comala workflow is active in the space).
A space administrator can also publish all the pages displayed in the filtered report using the Publish pages button.
After publishing, a space publishing report is generated and displayed. Changing the report filter can affect the number of pages published.
Page-level restrictions on a page can affect the pages displayed in the report.
What is published or copied?
Home page and blog posts
Comala Publishing Cloud does not support publishing a space’s home page or blog posts.
Confluence version
When publishing an updated page that has already been published, Comala Publishing deletes it. It copies the updated page as a new page in the target space, and the Confluence page version in the target space is v1.
Publishing status
Publishing updates the Comala Publishing status on both spaces. However, it is not visible for users with view-only permission on the page.
In-page links
Publishing replaces an in-page link to the local page in the source space with the link 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 on a different page in the source space
Publish and syncing a page with in-page links
Page hierarchy
Publishing and syncing a page maintains the page hierarchy where possible. However, the order of the content is not necessarily maintained in some circumstances. Pages whose parent is not present in the target space are sometimes published to the root of the target space, and a warning message is displayed.
Maintaining the page hierarchy
Automated publishing using a Comala workflow
The Comala Publishing integration with Comala Document Management lets you publish pages using the applied workflow:
automatically publish a page on the transition to the final state in the workflow
configure space publishing to only publish pages in the final state of the workflow, excluding pages not in the final state from being published
automatically publish a page on a workflow event, such as an approval decision using one or more workflow triggers added to the workflow
Publishing using the final state in a workflow is also available using a Comala Document Control or Comala Document Approval workflow.