| Insert excerpt | ||||||||
|---|---|---|---|---|---|---|---|---|
|
| Table of Contents | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
...
|
Getting started
Comala Publishing for Confluence Cloud is a separate app that publishes Cloud publishes and syncs pages between spaces in the same Confluence site - from a source(draft) space .
...
A space administrator must enable publishing from a source space to a target (published) space.
...
Comala Publishing is used to publish your draft pages from one space to another space in the same Confluence site
Each publishing action copies each page's content from the source (draft) space to the target (public) space, maintaining the page hierarchy where possible.
To publish pages, a user must have view and edit permissions on the draft source space and the public target space pages.
Enable Comala Publishing for a space
Publishing must be enabled and configured for a space using the space tools App links to the Comala Publishing dashboard in the source (draft) space.
...
Publishing set up wizard
| Filter by label (Content by label) | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
In the Comala Publishing dashboard
choose Configure Publishing to open the space publishing configuration wizard to enable Comala Publishing in the space
| Info |
|---|
The publishing setup tool is only available if the space is being set up for the first time or any publishing configuration has been cleared using the Clear Publishing Configuration option. |
...
Publishing dashboard
When a target space is selected and saved in the publishing dashboard, and publishing is enabled, the app can publish a page from the current space to a target (public) space.
...
After adding the target space, you can use single-page and space publishing to move pages from this space to the target space.
The space administrator can configure the publishing settings for the space. You can:
prevent the copying of page content properties if there is a 3rd party app in the target space
use the single-page publishing to add a Publish button to each page in the source space, allowing your editors to publish each page on a page-by-page basis
The Publish space button publishes and syncs all the current space pages to the target space
Publishing permissions
To configure publishing
you must be a space administrator in the source and target space
To publish all the pages in a space, in the source space and target space
a space administrator requires view and edit permission for all the pages
a user publishing an individual page needs view and edit permission
You also need the following space permissions in the target space to publish:
View All
Add and Delete Pages
Add and Delete Attachments
Page-level restrictions on a page in the target space prevent a space administrator from publishing and syncing the source space page. As a space administrator, if you publish all the pages, a restricted page is not included in the list of 'Pages not published' in the whole space publishing report.
Two ways of publishing your pages
Once a space is configured for publishing, you can publish and sync pages using single-page publishing and space publishing to publish all the pages in a space.
Single-page publishing
A user can publish each page manually space and have Confluence permissions for both spaces.
After the space is set up for publishing, a space administrator can publish all pages at once and configure the publishing settings to grant or deny permission for page editors to publish on a page-by-page basis.
Both editors and space administrators can track the page sync state using the publishing report, which is accessed from the source space.
Enable publishing in a space
The space administrator can configure and enable publishing in a space using the setup tool in the publishing dashboard.
...
Publishing settings and permissions
After enabling the space for publishing by adding a target space, the space administrator can use the publishing dashboard to manage what is copied for a page and how pages can be published.
...
A user publishing a page and a space administrator publishing all the pages in a space require view and edit permission in the source space. By default, the add-on user is set as the user performing the publishing action, and the Comala Publishing app add-on user permissions in the target space are used for publishing.
If the app add-on user is not selected in the Select user performing publishing action setting, the user performing the publishing action needs view and edit permission in the target space as well as in the source space.
...
Page-level restrictions can affect the ability to publish a page if the publishing user is not included in the restrictions.
Publishing pages
There are two ways to publish pages using the app on its own:
Page editors can publish single pages 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
...
in an on-screen message
...
The space administrator can disable single-page publishing for a space. This can be useful if you want to limit publishing to the space administrator or manage your documentation and publishing together with an applied Comala workflow.
Space publishing
A space administrator Space publishing
Space administrators can publish all the content from pages in a source space 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 has no pages (except the home page), space publishing cannot occur and 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.
...
What is copied from a source space page when publishing?
Publishing and syncing a page maintains the page hierarchy where possible, although the order of the content is not necessarily maintained in some circumstances.
When the hierarchy is not maintained in a publish action, the page is published to the root of the destination space.
the content title
the content body
attachments
content properties*
content labels
The Comala Publishing status is copied but is not visible on the content for users with view-only permission.
When publishing, in-page links to local pages in the source space are replaced with the links 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
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.
What is not published or copied?
Comala Publishing Cloud does not support publishing
the home page of a space
blog posts.
custom content properties for apps
the source space Confluence version
The following is also not published from the source space
inline comments
page-level permissions
comments
archived pages
Content properties are copied by default when publishing a page. In the space settings publishing dashboard, this can be disabled for a space.
Related Links
...
Comala Publishing also works with our Comala Document Management family of apps using an added Comala workflow. Adding automated workflows to your pages and spaces helps you better manage the document lifecycle, automatically allowing audiences to see published pages upon approval.
After publishing is configured for a space, you can track what pages and spaces are in sync using the publishing report.
...
The space administrator can also publish pages directly from the report.
Get started
| Child pages (Children Display) | ||
|---|---|---|
|