Localization

Create localization packages depending on what type and amount of content you need to localize. For example, you can use XLIFF Package to localize text only or Source Package to localize both text and media. You can localize standard, released, and branched content.

XLIFF Package Localization

XLIFF Package is a common localization format for Computer-assisted Translation (CAT) tools. easyDITA allows you to create XLIFF packages to localize your content. You create XLIFF packages from a map.

When you create an XLIFF Package, your map along with the associated DITA files are transformed to form one Extensible LADAR Format (XLF) file with the source text and placeholders for the target text for each target language.

Because XLF is one file with all content, XLIFF packages are useful especially for the localization of small publications and for projects that can be completed by one translator.

The XLF file contains all the text content from the dependencies of the map, including the resource-only topics. It does not contain any media content.

Source Package Localization

Source Package is a localization bundle that you can create from a map. Source Package bundles together all files related to your map, including DITA and media files, in the form of a ZIP file that you can download and send to your localization provider. This means that, unlike in the XLIFF Package, files in the Source Package are not transformed to a different file format. They are sent in their original form.

Because they contain multiple DITA and media files, Source packages are useful especially for the localization of large publications and for projects that require cooperation of two or more translators.

Along with all files needing translation, Source Package contains all your warehouse and variable content. All content is stored in the Source Package in a folder structure that is identical to your easyDITA folder structure.

Media Package Localization

Media Package is a localization bundle that you can create from a map. Media Package bundles together all media files related to your map, for example, diagrams or screen captures, in the form of a ZIP file that you can download and send to your localization provider. No DITA maps or topics are included.

The media files are located in a folder structure that is identical to your easyDITA folder structure.

Media packages are useful especially when used together with the XLIFF Package, which contains no media content, and to send media files only for localization.

Release and Branch Localization

In easyDITA, you can localize not only standard maps but also released and branched maps. Standard maps are the maps that are accessible from the master branch. Released and branched maps are accessible from the Releases Tab and a specific branch, respectively. Releases and branches are versioning tools.

Releases enable you to archive content at a specific point in time. The released version can then be downloaded, branched, published, and localized whenever you want.

Branches enable you to create a parallel set of content so you can edit the branched content without affecting the original content and push changes from one branch to another.

Locales

Locales are versions of your content in a target language, for example, in Canadian French or Polish. In easyDITA, you can easily view the locales for a map, topic, or media file in the Locales Tab. The locales listed in the Locales Tab are locales for the standard map and the locales created for the releases and branches of the map. Standard maps are the maps that are accessible from the master branch. Released and branched maps are accessible from the Releases Tab and a specific branch, respectively.