Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

When using Comala Publishing to manage and publish pages from a source space in Confluence Cloud, internal and external links are handled carefully to ensure they work correctly after publishing.

When the link destination is a URL and is a source page includes an in-page link to another page in the source space, on publishing and syncing the page

  • the in-page link in the published target space page link points to the page in the target space page version, updating any display text and URL accordinglythese links are

The in-page link is automatically updated each time the page is published to prevent broken links

...

Links to pages in other spaces or external locations remain unchanged when publishing a page. Different Confluence link macro formats in on the source space page may can affect how Confluence displays the link on the published target space page.

InThe following in-page links to headers or anchors in are not updated when a page is published and synced:

  • an in-page link to a heading or an anchor on another page in the source space

added as the destination URL in a Confluence link type are not updated.
  • a link to a heading on another page in the source space

Table of Contents
minLevel3
maxLevel3
outlinefalse
typeflat
separatorpipe
printabletrue

Source space in-page link

Published target Target space published in-page link

URL

Displayed link on the source space page to another page in the source space:

url_link_withconfluencelinktoolbox.png

Displayed link on published and synced page:

cpc_url_displayed_targetspacepagelink_updated_displayofpagename_onpublishandsync.png
Info

The displayed published in-page link is replaces the URL displayed in the source space displayed URL with the title of the destination page in the target space.

Published and synced target space in-page link URL is updated with the space key for the target space and the target space page contentID.

The URL in the source space to another page in the source space (space key CPCD) is:

Code Block
https://appfire.atlassian.net/wiki/spaces/CPCD/pages/614696400/User+Guide 

The link URL in the published and synced target space CPCL is updated to point to a page in the target space:

Code Block
https://appfire.atlassian.net/wiki/spaces/CPCL/pages/646807689/User+Guide
  • space key is for the target space - in our example, CPCL

  • page contentID is for the published target space page - in our example, 646807689

The Both the published page and the published link URL uses use the same page name as the source space page and link.

The published URL link URL is updated to a destination URL for a page the target space.

Custom display text

Displayed link on the source space page to another page in the source space:

url_customtext_link.pngurl_customtext_link_editbox.png

Displayed link on published and synced page:

url_customtext_link.png
Info

The published in-page link is maintains the source page Display text link configuration.

Published The published and synced target space in-page link URL is updated with the space key for the target space and the target space page contentID.

The URL in source space with space key CPCD configured to Display text is:

Code Block
https://appfire.atlassian.net/wiki/spaces/CPCD/pages/614696400/User+Guide 

The published URL in the target space CPCL for the displayed link is

Code Block
https://appfire.atlassian.net/wiki/spaces/CPCL/pages/646807689/User+Guide
  • space key is for the target space - in our example, CPCL

  • page contentID is for the published target space page - in our example, 646807689

The published link URL uses the same page name as the source space page.

The published URL custom display text link URL is updated to a destination URL for a page the target space.

...

Source space in-page link

Published target Target space published in-page link

URL

Displayed link on the source space page to another page in the source space:

inline_url_withlinktoolbox.pngImage Removedinline_url_withlinktoolbox.pngImage Added

Displayed link on published and synced page:

inlinelinkdisplay.pngImage Removedinlinelinkdisplay.pngImage Added

Inline link URL in source space with space key CPCD is:

Code Block
https://appfire.atlassian.net/wiki/spaces/CPCD/pages/614696400/User+Guide 

Inline The published inline link URL in the target space CPCL is:

Code Block
https://appfire.atlassian.net/wiki/spaces/CPCL/pages/646807689/User+Guide
  • space key is for the target space - in our example, CPCL

  • page contentID is for the published target space page - in our example, 646807689

The published inline link URL is updated to a destination URL for a page in the target space.

...

Source space in-page link

Target space published in-page link

Page in the source space

cpc_card_link_source_space.pngImage Removedcpc_card_link_source_space.pngImage Addedcpc_card_link_targetspace.pngImage Removedcpc_card_link_targetspace.pngImage Added

Card The card link URL in source space with space key PMCD is:

Code Block
https://appfire.atlassian.net/wiki/spaces/PMCD/pages/614696456/Product+Lifecycle 

Card The published card link URL in the target space PMCL is:

Code Block
https://appfire.atlassian.net/wiki/spaces/PMCL/pages/616696410/Product+Lifecycle
  • space key is for the target space - in our example, PMCL

  • page contentID is for the published target space page - in our example, 616696410

The published card link URL is updated to a destination URL for a page in the target space.

...

  • short page links

  • links to another page in the same Confluence site

  • links to another page on an external site

Source space in-page link

Target space published in-page link

Short link to another space or location

cpc_embed_link_source_space.pngImage Removedcpc_embed_link_source_space.pngImage Addedcpc_embed_link_target_space.pngImage Removedcpc_embed_link_target_space.pngImage Added

Card The card link URL in source space with space key PMCD is:

Code Block
https://appfire.atlassian.net/wiki/spaces/PMCD/pages/614696456/Product+Lifecycle 

Card The card link URL in the target space PMCL is:

Code Block
https://appfire.atlassian.net/wiki/spaces/PMCL/pages/616696410/Product+Lifecycle
  • space key is for the target space - in our example, PMCL

  • page contentID is for the published target space page - in our example, 616696410

The published embedded link URL is updated to a destination URL for a page in the target space.

...

  • short page links

  • links to another page in the same Confluence site

  • links to another page on an external site

...

Links to and from page headers headings and anchors are treated differently from page links added to the Confluence link macro types. When publishing a page that includes a header with an in-page When these link to another page in the source space page, the link is not updated . In-page links to a header or an anchor in another source space page are also not updated on publishing the page. In-page links created in macros, such as the table of contents macro,are updated if the macro is configured for the current space.

A link to another space page added to a page header is not updated on the published target space page. These links are treated as absolute links.

...

to the target space when the page is published.

Excerpt
nameheader_inpagelinks

In-page hyperlinks to headings /or anchors in another source space page are not updated to the destination target space pages when a page is published.

Example

In a source space page, Product Lifecycle, a link to a page headerheading, User interface in the source space page Product MVP is added as an in-page link.

Code Block
https://appfire.atlassian.net/wiki/spaces/PMCD/pages/614696410/Product+MVP#User+interface

The If you click the in-page link in the published Product Lifecycle published page in the target space for this page header is not , you are directed to the PMCD source space page. The link has not been updated to the target space Product MVP page.

In-page links on a source space page created using macros such as the children or page tree macros are updated.

When using Confluence page macros to add dynamic content to source space content, for example, the content by label macros, set a filter in the macro as the current space. On When publishing the page, the macro displays content in the target space.