A source space for publishing is configured in the publishing app space settings in the source space.
The app space settings are accessed by choosing Space Settings>App links>Comala 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 app space settings. |
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.
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 app space settings in the source space is 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 in the target space to use
the publishing user
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
The dropdown menu does not display any space that is currently configured using Comala Publishing as a source space or target space linked to another space.
The dropdown menu does not display any space that is currently configured using Comala Publishing as a source space or target space linked to another space.
After a space is published, details of the pages in the last space publication can be viewed using a link to the space publishing report added to the source space publishing app settings. |
Once a target space has been set in a source space, the target space publishing app settings displays confirmation that the space has been linked for publishing and a link to the source space. |
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.
The Enable publishing option allows publishing using the app, including single-page publishing, space publishing, and publishing using a Comala workflow.
The Enable publishing option allows publishing using the app, including single-page publishing, space publishing, and publishing using a Comala workflow.
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
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.
A target space must be added to allow access to the publishing dashboard settings.
A target space must be added to allow access to the publishing dashboard settings.
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
If the space administrator attempts to change from an existing target space, refreshing the dashboard page returns the app space settings to the existing target space configuration. |
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.
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.
Make this option inactive if you want to limit the publishing of pages for each space using the space settings Publishing dashboard. You might also choose to make single-page publishing inactive if a Comala workflow is being used to publish pages. |
When publishing a page, the space administrator can enable or prevent the copying of content properties.
By default, this is enabled.
Disable this option if you are using an app in the target space that will be impacted by copying the page properties from the source space page. For example, this can be disabled if a Comala workflow is applied in the target space. |
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.
A Publish button option is available to publish and sync all the pages in the space to the target space.
After changing the target space, a publishing action publishes the pages in the new target space, including any pages previously published to a different target space.
After changing the target space, a publishing action publishes the pages in the new target space, including any pages previously published to a different target space.
When a target space is configured in the source space, the target space app space settings displays a message confirming the target space as a published space and details of the source space.
A space administrator can clear the existing publishing configuration, including the removal of the target space, using the Clear Publishing configuration option in the three-dot menu.
You need to confirm the removal of the publishing configuration and synchronization of the two spaces.
After clearing the configuration, the publishing app space settings display the Configure Publishing setup wizard tool.