Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
Table of Contents | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Excerpt | ||
---|---|---|
| ||
You've installed the app, now what? |
You've installed the app, now what?
You will need to edit the Comala Publishing global configuration and then configure each individual space.
Configure the app
Configure the app global permissions
Image AddedSpace publishing configuration and copy space configuration
add/amend the Confluence user group members that can publish content
add/amend the Confluence user group members that can copy content
define the spaces can be published
In the app global configuration
the app Publishers Group can publish content. The default setting is the
confluence-administrators
groupANY space can be linked to another space and published
Users who will be publishing content will need to be both
members of the Confluence group added to the app Publishers Group
have space admin permission for the space to be published (the draft space) and the published space
Snapshot publishing configuration
add/amend the Confluence user group members that can snapshot publish the content
define the spaces can be snapshot published
If using Comala Document Management prior to v7.20 you need generate user tokens for snapshot users
Configure the space for space publishing
In space tools, Comala Publishing can be used to link two spaces - these will be a draft space and a published space.
You will need
space admin permissions for both spaces
to be a member of the Confluence group added to the app Publishers Group
You can then configure the content to be published and initialize the synchronisation of the two spaces.
Linking the draft and the published space
There are two options to set up the draft and published spaces:
Option 1: Publish content from one space to a new published space.
Option 2: Publish existing public content, from a new draft space.
Here are two example scenarios that can help you understand these two options.
Comala Publishing
childrenpagePublishing space contentOption 1: A new documentation space
Tip |
---|
Use this option if...
|
Let's say you're starting a new documentation space
your content is ready for your audience
you will occasionally update the content
you want a clean and approved version for your audience to read
You can create a new space, then use Comala Publishing to link and sync your draft documentation space with this new space, which will be the published version.
Any time you make a change to a page in the draft space, the page's state changes to out of sync until you publish the space or the page.
You first need to create a new empty space. This will be the Published space.
Image RemovedImage Addedlink the current space to the target space that will be the Published space
Image RemovedImage Addedchoose Publish to synchronize the content in the two spaces
Info |
---|
Before choosing Publish you can
|
Once synced, you can make changes to your content in the new draft space (the source space) then publish the whole space or individual pages.
Option 2: Adding to a populated space
Tip |
---|
Use this option if...
|
Let's say you have a space that
is rich in content
already has comments
has users watching pages and user labels
You need a new draft space you will publish to this pre-existing populated space.
You first need to create a new empty space. This will be the Draft space.
The existing populated space will be the Published space and the initial configuration of Comala Publishing for this Option 2 is in space tools in this populated space.
In the populated Published space space tools use Comala Publishing option to Publish from another Space
Image RemovedImage Addedlink the two spaces using the dropdown menu
choose Synchronize to copy the populated space content to the new Draft space
All the content on the populated space will be copied over to the Draft space.
Info |
---|
Before choosing Synchronize, you can select Advanced options to manage the configuration for this initial copy process. For example, you might need to consider unchecking Ignore Top-Level Pages to ensure the populated space home page and any other orphan or top-level pages are copied to the new draft space. |
Once this initial synchronization is done, navigate to the new linked Draft space.
In the new Draft space you can configure publishing options to decide how to handle deleted pages, labels, properties and more.
all further configuration and publishing of Comala Publishing is undertaken in this linked Draft space
You can make changes to your content in the new Draft space then publish the whole space or individual pages.
Unlinking the spaces can only be completed in the Draft space space tools Publishing dashboard.
Exclude some page content from being published
What can you do if you don't want some of the page content to be published?
Comala Publishing provides a simple solution.
You can
place the content that you don't want published in the body of the macro
Copy space content
Comala Publishing can also be used to simply copy a space to another space. This will be a snapshot of the current space at the time of the copy. There is no sync between the spaces after the copying of the content has been completed.
Users who can copy spaces will need to have
space admin permission in the draft space
at least view, edit, delete permissions for pages, blogs, attachments and comments in the destination space
be a member of the Confluence user group added to the app global publishing configuration Copiers Group
Snapshot space publishing
Use snapshot publishing to create static versions of a Confluence document at specific moments in time, ensuring that the content remains unchanged and compliant with regulatory or quality standards.