How to link to the correct page when using an Inclusion Library?

Question

We are setting up an Inclusion Library so that we can re-use content across several User Guides.

The issue we are facing is that links that are in the content in the Inclusion Library go to the wrong articles when that page is included in the various User Guides.

Right now we have several Spaces: _Library (the inclusion library), Website Guide, Data Management Guide, etc.  The same page from the _Library will be included in the Guides, but when we do that, any links to other pages are "broken".

We need the link to go to the article that is in the current User Guide, not to any hard-coded article that is setup in the Inclusion Library.

Michelle Rau HP · Answer

I realize this is an old topic but if you've found a solution I'd like to hear it.

Two things that occurred to me when I read your question were 1) the Alias macro from ServiceRocket (free) and 2) shortcut links. I haven't thoroughly researched these yet but perhaps there is some cheese down one of those tunnels?

https://docs.servicerocket.com/redirection/macro-reference/alias

https://wiki.bitvoodoo.ch/display/public/BVTHEME/Page+Alias

https://support.atlassian.com/confluence-cloud/docs/configure-shortcut-links/

Steffen Heller · Answer

What I haven't understood so far: Where is the link supposed to go?

* To a "normal" page from the Library space or any other space -or-
* to a page from the Library space that is itself included in another page?

Richard Saffell_cdvenv · Answer

Thanks for your reply and your time, Milo.  I have no idea how the Inclusions Library can work to re-use content (at the page level) if the content can't have links.