Use the Scroll Non-Translatable (inline and block) macros to mark content that should not be translated.
When you translate documentation into other languages, you may want to keep certain terms or passages exactly as they are. The Scroll Non-Translatable macros let you mark content that should stay in its original form across all translations.
The Scroll Non-Translatable Macros
There are two Non-Translatable macros, each suited to a different kind of content:
-
Scroll Non-Translatable (block): A bodied macro that holds longer passages of rich text or media that shouldn't be translated, such as addresses, company slogans, or formatted content.
-
Scroll Non-Translatable (inline): Used within sentences to mark specific terms or phrases as non-translatable. Only plain text is supported in this macro.
How the Macros Behave by Translation Method
The macros work slightly differently depending on how you translate your content.
XLIFF translation
In XLIFF translation, both macros mark content as non-translatable, but they're handled differently in the export:
-
Block macros are marked with the
translate="no"attribute and don't appear in the translator's view, since their content should be kept as-is. -
Inline macros appear in the export for context but are marked as protected. If a translator changes the protected content, the change is discarded when the translation is imported.
Confluence translation
For in-Confluence translation, non-translatable content is wrapped in the Scroll Non-Translatable macros to signal that it shouldn't be edited. The content can still technically be changed, so accidental translations aren't reverted automatically, you'll need to revert them manually.
Format Inline Content with Markdown
You can format the text inside a Scroll Non-Translatable (inline) macro using markdown. For example, **product A** renders as product A. The macro preview shows how the formatting will appear.
In the table below, you'll find markdown syntax supported in the macro:
|
Style |
Supported markdown |
|---|---|
|
Bold |
|
|
Italics |
|
|
Underline |
|
|
|
|
|
|
|
|
Color |
|
|
Subscript |
|
|
Superscript |
|
Scroll Sites doesn't yet render markdown formatting from this macro. The text appears as normal page text when published to Scroll Sites.