Overview
You can configure options for publishing pages and blog posts in a space. Publishing can be single-page publishing and space publishing.
Publishing Options include
- choice of 5887000894 (pages, blog posts or both) to publish
- 5887000894such as labels, page-level restrictions
- publishing based on 5887000894 (value set by a global administrator)
- 5887000894
Publishing options set in Configure will apply to content published via both space Publish and single page-level publishing.
Configure publishing
Open the space tools Publishing dashboard
Choose the Configure button
Publishing scope
Content publishing can be undertaken as a whole space or for a single page.
Publishing configuration can be set in the Publish Space scope or the Publish Page scope.
Settings changed in one publishing scope will also apply to the other scope.
A space admin can disable single-page publishing for a space.
To disable single page publishing
- choose Publish Page scope
- disable Enable Single Page Publish by moving the slider from the green tick to a grey cross
Target space
Target is the current linked space for publishing.
The target space can be changed using the Target dropdown menu.
Choose the Unlink from .. option to remove the target space.
Unlinking the target space will not change the content in either the draft space or published space.
Publishing Settings
Content type filters
Content to be published can be filtered to publish
- blog posts
- pages
- or both pages and blog posts
When choosing to publish pages, by default top-level pages are not published
- check the option to include Top-level pages (the draft space home page and any orphan pages) when publishing
Filter content using the sync-label
Content to be published can also be filtered by using a sync-label
- the label used as the sync-label is set in the Publishing app global configuration
default label global value on app install is syncme
If Use sync-label is checked you can choose how it will be used.
When using sync-label you can either
- Publish only content with the sync-label
- Publish content without the sync label
You can choose to include child pages of a page with the sync-label.
The sync-label can also be set to be ignored for blog posts - all blog posts will then be published if blog posts are set to be published.
You can set Delete sync-label after publishing for all content in the source space after publishing. If set, the sync-label will be removed whether or not you have chosen to use the sync-label as a content filter.
Data to include
These options allow the choice of the content data to include in the pages and/or blog posts to be published.
Content labels (except the sync-label) can be included when publishing the content. If choosing to include content labels you can match the labels on the content in the source and published space.
If the Match labels option is checked
- all existing published content will be updated to match labels on the content in the source space
- existing source content labels will be removed
- the sync-label, if present, will be added to the published content
The data can be set to include or exclude
- source content page restrictions copied from the source content to the published content
- "What did you change" user update comments
You can also choose to include data related to the ServiceRocket Scaffolding Forms and Templates app
Publishing Options
The published content can be set to have either
- lastest modification date for the source content
- the date of publishing
Comala Publishing is compatible with the Comala Document Management Family of Apps. Publishing the content can be set to the corresponding final (published) state in the Comalatech workflow applied to the source content.
You can also choose when publishing to
- delete all content in the published space that is not in the source space
- remove all page history form the published content
- publish all the source congtent not just the content that has been updated
When you first publish a space you may need to set Publish to Delete Pages added in Target Space. This will cause the draft space home page to be published and to become the published space home page. The original home page in the published space is deleted.
If you don't want to publish the draft space home page you can configure the draft space Publish settings to ignore Top-level pages in the draft space for the publishing. This setting also means that any orphan pages in the draft space will not be published.
Display options
To help identify the source and published content a draft watermark can be added to the source space icon.
You can also choose to enable the addition of publishing status lozenges to your content to help in tracking the current status of your publish space and source space.
If Display Publishing Status Lozenge is checked the publishing status lozenge is displayed on the source space content.
The lozenge on each piece of content
- is set as Published PUBLISHED when content is synchronized
- is Out of Sync OUT OF SYNC when the content is not synchronized
- is New NEW when the content has not yet been published
If you are using Comala Document Management which provides its own status lozenges, it is recommended that you disable the display of the Comala Publishing app lozenges in the source space.
If the Publish Settings are changed - for example, the option Always Publish is checked - this may cause pages to be displayed as out of sync in View Changes. Content will also be displayed in the published space with an Out of Sync lozenge.
Target space publishing lozenge
The behavior of the publishing status lozenge on the target space content is not affected by the Display Publishing Status Lozenge option.
The publishing status lozenge displayed on the target space content is dependent on the current user Confluence permissions on the content in the source space.
lozenges are displayed on the target space if the current user has at least view permission on the source space content
lozenges are not displayed if the current user does not have view permission on the source content
The display of the target content link to the source space content is also dependent on the user permission on the source content
Publish Settings Summary
| Publishing Setting | Publishing Option | Description |
|---|---|---|
| SCOPE | Publish Space | Publish all content from a source space to a target published space
Changes to Publish Space scope settings will be applied to Publish Page scope settings. |
Publish Page | Publish a single page from a source space to a target published space
Changes to Publish Page scope settings will be applied to Publish Space scope settings. Publish Page scope can be enabled/disabled in Settings.
If disabled, this option lets you restrict space admins to whole-space publish. If enabled then users can publish individual content even if it is not included in the Publish Options Content Filters for content to be published. For example, if blog posts are not checked in Content Filters they will not be included in any whole space publish but can still be published individually by a user from the page view. | |
| CONTENT FILTERS | Copy Blog Posts | Blog posts are included in the publish. If not selected, blog posts are ignored. |
| Copy Pages | Pages are included in the publish. If not selected, pages are ignored. | |
| Ignore Top-level Pages | Don't publish top-level pages (such as the space homepage) and other orphan pages. If the space has multiple page trees each starting with a top-level page, each top-level page will not be published. | |
| 5887000894 | If checked
If unchecked
The sync-label is set by global administrator. When using the sync-label the synchronization can be customized with the following options
| |
| Publish content with the sync label | Checked by default on choosing Use sync-label If checked
If unchecked
| |
| Publish content without the sync label | If checked
If unchecked
| |
| Include child pages | If checked, the sync-label synchronization will be applied to the page with a sync-label AND ALL its child pages. | |
| Ignore sync-label for Blog Posts | If selected, the sync-label as defined in Publishing Configuration in Confluence Admin is ignored for blog posts. All blog posts will be published (if set in the content filter) irrespective of the sync label. | |
Delete sync-label after publishing | If checked
This will occur whether or not the sync-label is used. For example, let's say the sync-label is private and you add the label private to a draft space page. If this option is selected then after the space is published, the private label is removed from the draft space page. | |
| DATA TO INCLUDE | Labels | If selected, labels are published on target pages, blog posts, and attachments.
|
| Match labels | Checking this option causes an exact copy of all labels from a draft page/blog post to be added to the published space page/blog post including any sync-label. Any existing labels on the content in the published space are removed and replaced by the labels on the content in the draft space. | |
| Content Properties | if checked Content Properties associated with other plugins will be published.
Page properties are attributes associated with a page usually defined by other apps. See the other app's configuration to determine the prefix of these properties. | |
| Restrictions | If checked
| |
| Scaffolding | If active (ServiceRocket Scaffolding app or macros enabled) and checked
Note that only the latest version data is published. | |
| Version Comments | Publish the page's version comment (any change comment added by a page editor on updating the content). | |
| PUBLISHING OPTIONS | Set content modification date in target space as: | |
| Latest modification date | Checked by default
| |
| Publish date | If checked
| |
| Use final state | If checked
This option only publishes content with a new final/published version since the last time the space was published. Note
| |
| Delete target space content (pages and blog posts) | If selected, content that exists in the public space but not in the source (draft) space (out-of-sync pages) are deleted. If not selected, out-of-sync pages are unaffected. Pages that only exist in the public space are not deleted. A notification on View Changes shows pages that are out of sync: pages exist in the public space but not in the draft space. | |
| Override Content | If selected, no new versions are created. Page history is not kept
| |
| Always publish | If unchecked (default)
If checked
Note that the View Changes report (the manifest record) may change if publishing options are changed. | |
| DISPLAY OPTIONS | Draft Watermark | If checked, a draft watermark is displayed above the space logo when you are in the draft space. |
Controls the display of the publishing status lozenge on content in the source space If checked
Recommend that this be disabled when using Comala Document Management to handle publishing which provides its own status lozenges. Note: the behavior of the lozenge display on the target content is not affected by this option setting. The display of the publishing status lozenge on the target space content is dependent on the user permissions for the source content. |
