Get started - Publishing pages
- Robert Alexander Marshall
There are two ways to publish your pages
After a space administrator has configured a space for publishing 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.
Single-page publishing
An editor 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.
Successful publishing also displays an on-screen message with a link to the published page in the target space.
You may need to 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 sync them.
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. The displayed pages can be filtered based on their publishing status.
A space administrator can publish all the pages displayed in the report using the Publish pages button. After publishing, the space publishing report is generated and displayed. Changing the report filter can affect the number of pages published.
What is published or copied?
Home page and blog posts
Comala Publishing Cloud does not support publishing the home page of a space or blog posts. Inline comments are not copied, but content properties are.
Confluence version
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.
Publishing status
Publishing updates the Comala Publishing status on both spaces. However, it is not visible on the page for users with view-only permission.
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 in a different page in the source space
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.