Source space publishing dashboard
- Robert Alexander Marshall
- Comala Publishing for Confluence Cloud
Overview
A source space for publishing is configured in the publishing dashboard in the source space.
The publishing dashboard is accessed by choosing Space Settings>App links>Publishing.
The Configure Publishing button opens the space publishing configuration setup tool to add a target space to publish your pages to.
The Configure Publishing button is only displayed if no target space has been added to the publishing dashboard.
Once a target space is configured for a space, publishing is enabled for the space by default.
When adding a target space, the Enable Publishing, Copy content properties, Enable single-page publishing options, and the option to Space Publish are all displayed and enabled by default.
The publishing dashboard in the source space can be used to
enable all publishing from the current space to a target space
configure a target space for publishing
set the user permissions for publishing to use the app add-on user or the publishing user permissions in the target space
enable or prevent copying of content properties when publishing a page
enable single-page publishing for the space to allow page editors to publish on a page-by-page basis
enable publishing of only pages in the final state of an applied Comala workflow
publish the whole space using the space publishing option
Publishing settings and options
Enable publishing
Enables the publishing of pages from the current space (source space) to a target space
disabled by default if a target space has not been configured
Adding a target space automatically sets Enable publishing as enabled and allows the publishing of pages.
Disabling the Enable publishing option
disables all publishing features of the app, including single page publishing, space publishing, and publishing using a Comala workflow
hides the Copy content properties option, Enable single page publishing option and, the Space Publishing option
Target space
Select the target space where the source pages are published and synced. Use the dropdown menu to select a target space and choose Change. Only spaces where the current user has space administrator permission are displayed as options in the menu.
When changing the target space, if a space administrator lacks the necessary permissions in that target space, the source space dashboard options are disabled, and a message appears indicating insufficient permissions
User permissions for publishing
You can choose the user permissions in the target space that are used for publishing:
Comala Publishing for Confluence Cloud app add-on user permissions
User who triggers the action
By default, for a new space publishing configuration, the Comala Publishing for Confluence Cloud app add-on user permissions in the target space are used for publishing actions.
When publishing is configured to use the app add-on user, only the app add-on user requires edit permission in the target space. There is no need for a Confluence user who publishes content (a page editor or a space administrator) to have edit permissions in the target space. Removing user edit permissions in the target space can support compliance with published documents.
Single-page publishing
You can enable or prevent a page editor from publishing an individual page using the Publish option in the publishing popup on a page in the source space.
If single-page publishing is disabled in a space
the Publish button is not displayed in the popup
space publishing can still occur
individual pages can still be published using an applied Comala workflow
By default, this is enabled.
Copy content properties
When publishing a page, the space administrator can enable or prevent the copying of content properties.
By default, this is enabled.
Only publish pages if they are in the final state of the workflow
When publishing all the pages in a space using space publishing, you can enable this setting to only publish the pages in the final state of an applied Comala workflow.
a Comala workflow must be active on a page
a page must be the final state of the workflow
only unsynced pages are published
Pages not in the final state of the workflow are ignored for publishing.
Space publishing
A Publish button option is available to publish and sync all the pages in the space to the target space.
When a target space is configured in the source space, the target space Publishing dashboard displays a message confirming the target space as a published space and details of the source space.
Clear Publishing configuration
A space administrator can clear the existing publishing configuration, including the removal of the target space, using the Clear Publishing configuration option in the ellipsis menu.
You will need to confirm the removal of the publishing configuration and synchronization of the two spaces.
After clearing the configuration, the publishing dashboard displays the Configure Publishing setup wizard tool.
Related pages