Preparing Content for Translation

MadCap Lingo ZIP Package

 

Extension .zip
Smartling Identifier madcap
Example File madcap.zip
Resources MadCap Lingo software 

Smartling supports Madcap Lingo version 10.

A MadCap package is a ZIP-archive with one or more XLIFF files, optionally organized in directories. A MadCap archive is treated as a single file. Translated strings in the archive will be associated with the .zip file, not the individual XLIFF files.

Non-XLIFF files in the archive are excluded from processing.

Directory structure and non-XLIFF files are preserved when downloading the translated archive.

Directives

Format

<!-- smartling.[directive_name] = [value] -->

 

entity_escaping

Exact delivery depends on file type.

Value auto (default)
true (or yes)
false (or no)
Description Can control whether or not characters will be "escaped" into entities when delivering translations. This can be set universally for the whole file via API, or by setting the directive at the top/start of the file. The directive can also be placed inline to control the behavior of specific strings.
Examples

To use inline:
<!-- smartling.entity_escaping = false -->

String:
<!-- smartling.entity_escaping = auto -->

For example, your translation might look like this:
Smartling HTML escaping < > & " example string4

By default, using the "auto" setting, we would assume this is HTML from the <hr> tag and it would be converted to:
Smartling HTML escaping &lt; &gt; &amp; &quot; example string4

Using smartling.entity_escaping = false would allow Smartling HTML escaping < > & " example string4 to appear as it should.

Was this article helpful?