To make content reuse work properly with translated content, Scroll Translation comes with its own version of the Include macro, (called the Include+ macro) and the Excerpt Include macro (called the Excerpt Include+ macro). These make reusing content within translated spaces a snap.
The Include+ macro
The Include+ macro is an overhauled version of Confluence's Include macro. It highlights included content, shows you the source of the content on mouseover, and also displays the other pages that also use this content. With Include+ macro the corresponding language of the included content is displayed.
How do I use it?
Insert the Include+ macro as you would any other macro, then select which page you want to include. The selected page's content will be included where you inserted the macro. Any existing Include macros will be automatically converted into Include+ macros when you edit a page for the first time after activating Translations. If you have created a new page and manually selected Include macro, it won't be converted automatically as the app assumes that a user is deliberately making this decision.
To view the title and language of included source page, hover over the content highlighted in a light-gray box. If a pop up doesn’t appear, check if the Highlight included content checkbox is activated in User profile picture → Scroll Settings
Furthermore, in the Versions Menu, you can check whether the page you are currently viewing is included anywhere else in the currently selected version by clicking on Include Information.
Reusing translated content from other spaces with the Include Library
To reuse content from other translated spaces, an extra step is required. In the space where you want to reuse content, configure which translated spaces you want to include from. Languages need to be mapped in order for the Include+ macro to know which language to include from.
Add spaces to include from
Note: you need to have space admin permissions in both the current space and the space you want to add.
- Open the space where you want to include content.
- Add a space to include from by clicking Space tools > Scroll add-ons > Administration > Include Library > Add space
- Find the space that contains translated content to be included.
- Go through the steps in the dialog and map all languages that you want to include from
Once languages have been mapped, and a space has been added, you can use the Include+ macro to reuse content both from the current space and the added space.
Limitations and constraints
- You can only add spaces that are not using include Library themselves.
- You cannot add spaces that have variants.
- Reused pages need to contain all attachments they use themselves.
- Reused pages can not reuse other content themselves.
- Make sure all links on reused pages are reachable also where they are included
The Excerpt Include+ Macro
The Excerpt Include+ macro is a modified version of Confluence's default Excerpt Include macro, which is used to display sections of one page in another. Excerpt Include+ Macro has been reworked to function correctly in translated spaces.
How do I use it?
Include any content you want to duplicate in a normal Excerpt macro, and then insert an Excerpt Include+ macro on the page where you want it to be duplicated. Excerpt Include+ macro will only include the content in the first Excerpt macro on the source page. So only one Excerpt macro can be used per page.