| Insert excerpt | ||||||||
|---|---|---|---|---|---|---|---|---|
|
...
Comala Publishing for Confluence Cloud is a separate app that enables the publishing of publishes pages between spaces in the same Confluence site - pages are published from a source(draft) space to a target (published) space.
...
The Each publishing action copies each page’s page's content from the source (draft) space to the target (public) space, maintaining the page hierarchy where possible.
To publish pages, a user requires must have view and edit permissions on both the draft source space and the public target space contentpages.
Enable Comala Publishing for a space
Publishing must be enabled and configured for a space via space using the space tools App links to the Comala Publishing dashboard in the source (draft) space.
...
Publishing setup wizardset up wizard
| Filter by label (Content by label) | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
In the Comala Publishing dashboard
choose Configure Publishing to open the space publishing set-up configuration wizard to enable Comala Publishing in the space
| Info |
|---|
The publishing set-up setup tool is only available if the space is being setup set up for the first time or any publishsing publishing configuration has been cleared using the Clear Publishing Configuration option. |
...
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.
...
By default, on
After adding the target space the following options are displayed.
...
Publishing Setting
...
Default - on adding the target space
...
Notes
...
Enable publishing
...
(Enabled)
...
the app can publish content from your source space to your target space
must be enabled to allow both single-page publishing and space publishing of pages
must be enabled to allow publishing with a Comala Document Management family of apps workflow
...
Copy content Properties
...
Displayed as (enabled by default)
page content properties are copied when publishing a page in the space using single-page publishing and space publishing
...
can be disabled by the space administrator
...
, 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
...
Enable single page publishing
...
Displayed as (enabled by default)
...
adds a Publish button to each page in the source space to allow a user to publish each individual page to the target space
can be disabled by the space administrator so only whole space publishing can be undertaken
...
Space publishing
...
Displayed with Publish space button
...
a space administrator can publish all the source space content at one time
...
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 standalone publishing or with an applied workflow from one of the Comala Document Management family of apps.
These publishing actions are
| Table of Contents | ||||
|---|---|---|---|---|
|
single-page publishing and space publishing to publish all the pages in a space.
Single-page publishing
A user can publish each page manually using the publishing byline added to the page.
...
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 whole space publishing by the space administrator or publishing on manage your documentation and publishing together with an applied Comala workflow event.
Space publishing
A space administrator can publish all the content from 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.
...
Successful publishing is confirmed in the dashboard. The confirmation includes the The dashboard confirms successful publishing, including the date, time, and the user who actioned space publishing.
...
If the space publish action was unable to cannot publish all the source pages, the space publishing dashboard will display a listing details of the unsuccessful pages are displayed.
...
If the space has no pages (except the home page), space publishing will not occur. This will be cannot occur and is confirmed in an on-screen notification.
...
Publish content on an applied Comala workflow event
You can also choose to publish pages together with an applied Comala Document Management workflow.
...
A Comala workflow can invoke the publishing action to a specified target (public) space when the workflow reaches the workflow final state on the page in the source (draft) space.
...
Publish pages using a workflow JSON trigger
Comala Document Management workflow can be edited to add an event trigger to publish a page, for example, on a change of state event.
Code Block [{"event":"_transition/change-state","conditions":[{"state":"In Approval"}],"actions":[{"action":"publishing/sync-page"}]}]
Publishing confirmation
Successful publishing of a page to the target space is confirmed in an on-screen message.
...
A message is displayed on a page for a single-page publish action and a successful publish action using a Comala workflow.
You will need to refresh the source space page to display the publishing confirmation message.
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 on 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.
Each published page will includeincludes
the content title
the content body
attachments
content properties*
content labels
When publishing the page
links
The Comala Publishing status is copied but is not visible on the content for users with view-only permission.
When publishing, /wiki/spaces/CPCL/pages/1286602822 to local pages in the source space are replaced with the links for the
...
page in the target space.
When publishing a previously published updated page
...
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
...
| bgColor | #DEEBFF |
|---|
...
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 Comala Read Confirmations app and Comala Document Management Family of apps
the source space Confluence version
...
inline comments
page-level permissions
comments
archived pages
Publishing status is copied but is not visible on the content for users with view-only permission.
Content properties are copied by default when publishing a page. This can be disabled for a space in In the space settings publishing dashboard.
Page hierarchy
The publish action maintains the page hierarchy where possible although in some circumstances, the order of the content is not necessarily maintained.
When the hierarchy is not maintained in a publish action, the page is published to the root of the destination space.
the hierarchy is maintained as long as the parent page exists in the destination space
if the hierarchy cannot be maintained the page is copied into the root of the destination space and a warning message is shown to the user
...
If a previous publish action resulted in the page being published to the root of the destination space, any subsequent publishing of the source space page copies the page but not changes in the page tree parent.
Publishing user permissions
To configure publishing a user needs to have space administrator permission in the source space and target space.
When publishing space pages
a space administrator requires view and edit permission for all the pages in the source space and target space
a user publishing an individual page needs view and edit permission for the page in the source space and target space
A user also needs to have the following permissions in the target space to publish a draft page:
View All
Add and Delete Pages
Add and Delete Attachments
For successful publishing, the published page has no page-level restrictions limiting access in the target space.
Comala Publishing does not publish a page If the space administrator does not have view/edit permission for a page AND the page is not included in the list of 'Pages not published' in the source space Publishing dashboard report when the space publishing action is complete.
Related Links
Publishing
| Child pages (Children Display) | ||
|---|---|---|
|
Publishing space administration
| Filter by label (Content by label) | ||||||
|---|---|---|---|---|---|---|
|
Comala Document Management Family of apps
...
Comala Document Management for Confluence Cloud
...
Comala Document Control for Confluence Cloud
...
, this can be disabled for a space.
Related Links
| Child pages (Children Display) | ||
|---|---|---|
|