Question
I am trying to use a macro in a translated space, and it's not working properly. What's the reason, and how do I fix it?
Answer
In translated spaces, every translated page actually contains all languages in a space within specific macros. This is how Scroll Translations provides multiple language versions of the same page. Of course, Confluence 'sees' those translated pages as normal pages with all separate language content in it – and this often causes certain third-party apps and macros to render the content in unexpected ways.
In Scroll Versions and Translations, we provide compatible alternatives of the macros that are necessary for documentation authoring spaces (see the reference table below for details). Please keep in mind, that macros generally have more data to process in translated spaces, which can lead to higher cache requirements or longer load times.
However, it's simply not possible for us to build alternative versions of every macro that behaves unexpectedly in translated spaces – the support for certain apps and macros is considered a feature of Scroll Translations. If a certain macro or app doesn't work, this is not a bug.
Macro compatibility
Built-in macros
|
App/macro name |
Compatibility |
Notes |
|---|---|---|
|
Page Properties macro |
|
Starting with 3.8.8 release in combination with Confluence 6.6.1 and later, this macro is aware of space versions and languages. |
|
Page Properties Report macro |
|
Starting with 3.8.8 release in combination with Confluence 6.6.1 and later, this macro is aware of space versions and languages, but does not support pagination, which can lead to longer load times. Some macro parameters prevent it from working correctly in translated spaces: VSN-4176
|
|
Include macro |
|
Use Include Plus in translated spaces |
|
Excerpt Include macro |
|
Use Excerpt Include Plus in translated spaces |
|
Scroll Metadata macro |
|
|
|
Page Tree macro |
|
Use Scroll Page Tree in translated spaces |
|
Children Display macro |
|
|
|
Content by Label macro |
|
Some macro parameters prevent it from working correctly in translated spaces: VSN-4176 |
|
Activity Stream macro |
|
|
|
Anchor macro |
|
|
|
Attachments macro |
|
|
|
Blog Posts macro |
|
|
|
Change history macro |
|
Shows the page history of a particular translated page |
|
Chart macro |
|
|
|
Cheese macro |
|
|
|
Code Block macro |
|
|
|
Column macro |
|
|
|
Content by User macro |
|
|
|
Content Report Table macro |
|
Might display default language titles. |
|
Contributors macro |
|
|
|
Contributors Summary macro |
|
|
|
Expand macro |
|
|
|
Favorite Pages macro |
|
Might display default language titles. |
|
Gallery macro |
|
|
|
Labels List macro |
|
|
|
Livesearch macro |
|
Displays page titles the way Confluence "sees" them (default language) |
|
Loremipsum macro |
|
|
|
Multimedia macro |
|
|
|
Navigation Map macro |
|
Might display default language titles. |
|
No Format macro |
|
|
|
Note macro |
|
|
|
Page Index macro |
|
Might display default language titles. |
|
Page Tree Search |
|
Might search & display default language titles. |
|
Panel macro |
|
|
|
Popular Labels macro |
|
|
|
Recently Updated macro |
|
Might display default language titles. |
|
Roadmap Planner macro |
|
|
|
Search Results macro |
|
Might display default language titles. |
|
Section macro |
|
|
|
Tip macro |
|
|
|
Warning macro |
|
|
Third-party macros
|
App/macro name |
Compatibility |
Notes |
|---|---|---|
|
Gliffy |
|
|
|
Balsamiq mockup |
|
|
|
Draw.io |
|
|
|
Multi Excerpt macro |
|
See how content reuse is done in spaces with Scroll Versions and Translations |