Conversion with Include Libraries

Scroll Versions and Scroll Translations provide users with the ability to reuse content from other versioned or translated spaces. However, the process of reusing content between documents will be different when you convert to Scroll Documents.

This article outlines the changes in the concept of an Include Library that you’ll experience when converting to Scroll Documents.

If the conversion outcome described below does not meet your needs, we recommend postponing the migration and contacting our support team at help@k15t.com for assistance.

Include Libraries in Scroll Versions and Scroll Translations

In Scroll Versions or Scroll Translations, an Include Library is established by connecting an author space with a library space. This connection is based on version and/or language mapping. The content from the library space is then reused in the author space using the Scroll macro called Include+.

Here's an overview of how the Include Library concept works between two versioned spaces:

Include Libraries after Conversion to Scroll Documents

When converting the versioned author space to Scroll Documents, the included pages and their images are copied to the new Scroll Document managed space. These copied pages are added as child pages under a new parent page named "_SvIncludeLibrary."

Since each version of your document has its own page tree, the new _SvIncludeLibrary and the copied child pages are added to each version. As a result, instead of reusing content from another space, each version of your document will now reuse content from its own _SvIncludeLibrary within that version.

During the conversion process, Include+ macros are transformed into Confluence native Include Page macros.

Here's an example of how the page tree of the Working version might look when it contains a converted Include Library:

Why Do I See a Warning on the _SVIncludeLibrary Page?

After converting to Scroll Documents, you'll also see the following warning panel on the _SVIncludeLibrary page:

This page contains content published from a space that is using an include library. Do not edit or move this page or its child pages. Doing so will affect your published content.

This warning is added to remind you that the child pages of this page are reused by other pages in the document. If you edit or move these reused pages, it will affect how the included content is displayed within the different versions of your document. Therefore, it is important to consider the impact on the pages that reuse this content before making any changes.

Tips

To see where a page is reused, go to the Confluence page view, click More actions (•••) > Advanced details > Page information and look for “Incoming Links.”