Overview
A space administrator can publish all source space pages to a target space (space-publishing) in a single action using the Publishing space option in the space settings Publishing dashboard.
The Publish space option is only displayed if a target space has been configured and publishing has been enabled in the space publishing dashboard.
Publishing does not include the space home page, blog posts, and archived pages.
The first time the source space is published to a target space
all the source pages are published
On a subsequent whole space publishing action, using the Publish space button
pages with a publishing status of New or Out of sync are published
pages with a Synced publishing status are not republished
This filtering of the synced pages reduces the time required to complete the whole publishing action.
The space administrator can also publish pages using the Publish pages option in the publishing report.
Publishing from the report can be filtered to publish
all the pages, irrespective of the publishing status
the pages that are not synced
Comala Publishing is designed to publish pages to an “empty” target space (except for the space homepage). Although a space with existing pages can be configured as a target space, if you set a target space that has some existing title pages that are the same as in the source space, this can cause publishing issues.
Publish a space
In space settings Publishing dashboard in the source space
scroll down to the Space publishing option
choose the Publish space button
A target space must be added using the Target space dropdown menu for space publishing to be active.
Administrators can choose to enable or prevent single-page publishing when space publishing is used in a space.
Administrators can also configure if the publishing action includes copying the content properties for each page.
Choose Publish in the dialog box to confirm the publishing of all pages in the space to the target space
Whilst space publishing occurs all other publishing by users (both page and other space publishing actions) is disabled until the publishing is complete. A publishing action using a Comala Document Management workflow trigger can still occur.
If the source space does not include any NEW pages to publish, OUT OF SYNC pages, or is empty
a No pages to publish warning message is displayed
This message may be displayed on initial space publishing of a space with a newly created single page. This may be due to the time required to update the space details with the newly created page.
If the source space includes pages that are already published, any pages with a SYNCED status are not published
only unpublished pages (NEW publishing status) and pages that are OUT OF SYNC are published
the number of pages to publish is displayed in the dialog box
choose Publish to confirm the publishing of the pages
Copying content properties
By default, the copying of content properties when publishing a page is enabled for the space. A space administrator can choose to disable the copying of content properties for source space pages in the source space settings publishing dashboard.
Space publishing progress bar
A progress bar displays the progress of the space publishing process.
Once the space publishing process finishes the progress bar will display confirmation that publishing is complete.
And a summary report of the completed publishing for the space is displayed.
Choose Back to return to the space publishing dashboard.
The last publication details are added underneath the Publish Space button in Space publishing.
Choose See details to display the space publishing report.
Partially completed space publishing
If one or more source space pages are not successfully published during a whole space publish a warning message is displayed in the progress bar.
Last publication details are added to the space publishing dashboard with a Partially completed publishing warning with a summary of the number of pages published.
Choose the See details option to view the space publishing report that displays a list of the pages that could not be published.
If the space administrator does not have view and edit permissions over a page in the source space, this page will not be published to the target space.
The page will also not be reported under the Pages that were not published listing in the space publishing job completed report. This is because the view and edit permissions cause the page to be hidden from any publishing action for this space administrator.
Space publish error
If there is a problem in completing the space publishing action, the following error message will be displayed.
Simply retry the publishing action at a later time.
For repeated problems in publishing your space please open a ticket with our support team.
Space publish after initial whole space publish
After an initial whole space publish, only new pages and previously published pages that are currently out of sync, are published using the Publish space option. The number of pages that are set to be published is displayed in the popup dialog box.
After space publishing is completed, the Space publishing details in the dashboard are updated with the Publish space action.
The details displayed are only for the most recent Publish space action. They do not display the total number of pages published in the space as some pages may have been published in one or more previous Publish space actions or by the single page publishing option.
Publishing pages from the publishing report
The source space pages displayed in the publishing report can be published by a space administrator.
The report can be filtered to display
all the pages in the source space with any publishing status
ANY STATE report filter
any state not synced (New; Out of Sync publishing status)
state NOT SYNCED report filter
The filtered list is published in a single publishing action using the Publish pages option in the report.
Publishing using the report
Open the publishing report using the Confluence sidebar options
choose Apps>Comala Publishing
The Publish pages button publishes the pages currently displayed in the report table.
The number of pages to be published is displayed on the button.
The Publish pages option is only displayed for a space administrator.
For example, for a publishing report for a source space with the state NOT SYNCED applied that filters to two pages:
Only the two listed pages are published.
Choose Publish to confirm.
The space publishing report is displayed upon completion of the publishing action.
If the publishing report for a space has the Any state filter applied and five pages are displayed, all of the displayed pages are published.
This space publishing action from the publishing report publishes all the displayed pages, even if the publishing state is SYNCED. This is different from a Space publish action in the publishing dashboard, where only unsynced pages would be published.
Last publication byline
The Last Publication byline option is displayed in the report if at least one previous whole-space publish action was undertaken using the Space publish option in the space publishing dashboard or the Publish option in the publishing report.
Select the byline to view:
a summary of the last whole space publish action
the See details link to the space publishing report for the last whole space publish action
