...
If you already have a space for content, your production space, you can easily and safely create a development environment for it using Comala Publishing.
Comala Publishing can be used to publish all the pages in one space (a source space) to another space (the target space) in the same Confluence site.
You can use Comala Publishing to
copy your current production space pages to a new space to use a development or draft space and then
publish and sync the new development space pages to the original production space
The development space can be used to draft, edit, update and check your page content before publishing to the production space.
Permissions
Before you can undertake any publishing, you will require space administrator permission to configure publishing and action a whole space publishing action.
...
| Note |
|---|
Any external resources that rely on these page ID's will need to be updated such as short link urls, in-app urls, or links from external sites. |
...
In-page hyperlinks
In-page links to another page in the source space will be updated on publishing.
Comala Publishing updates/modifies the space and contentID values within the page URL.
For example
adding a hyperlink in a page in the source DEV space
...
When published to the target PROD space
the link will be updated to link to the published page in the target space
...
Hyperlinks in a page that link to other pages in the source space, must include the page name in the URLs along source page link URL together with the page contentID.
...
a URL that
...
contains only the page ID
...
may not be updated; they may work in your source space but on publishing to the target space, the link will not be fully updated.
...
A user choosing the link in the published target space will be directed to the source space page
...
Internal page links
Any in-page links internal to the space will be updated on publishing
For example
adding a hyperlink in a page in the source DEV space
...
When published to the target DEV space
the link will be updated to link to the published page in the target space
...
If you add a link to a page in another space in your Confluence site this will be treated as an absolute URL when publishing. It will not change on publishing the page to the target space.
If you link to a page that is in another space in the site that is separately configured for publishing using Comala Publishing, ensure that you link to the published target space page and not the source draft space page to avoid directing users to the source draft page. In this use-case the source space url link will be not updated on publishing. The link will be treated as an absolute
Links to in-page headings or anchors in another
In-page hyperlinks to headings/anchors in another source space page (except those created using macros such as the children or page tree macros) are not updated to the target space when a page is published. In the published target space page the link will redirect you to your source space page.
| Info |
|---|
When using page macros to add dynamic content source space content, for example the content by label macros, set a filter in the macro to use |
Deleting pages after publishing
| Insert excerpt | ||||||
|---|---|---|---|---|---|---|
|
...
If you publish a child page and the parent page is not present in the target space, the child page will be created and placed in the root directory of the target space. This is most likely to occur when using single-page publishing option as it only publishes the current page and the target space parent page no longer exists or has not yet been published. You may need to re-publish the parent page.
Hierarchy is maintained where possible when publishing - however in some cases the order in the hierarchy is sometimes not maintained and my need to be manually changed in the target space.
...