Localization Overview

Create several types of localization packages depending on what type and amount of content you need to localize. Use an XLIFF Package to localize text only or a Source Package to localize both text and media. You can localize source, released, and branched maps.

XLIFF Package Localization

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

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

A 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 a ZIP file that you can download and send to your localization provider. This means that, unlike 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, a 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

A Media Package is a localization bundle that you can create from a map. A 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 for sending only media files for localization, and for supplementing an XLIFF Package, which contains no media content.

Release and Branch Localization

You can localize not only source maps but also released and branched maps. Source 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.

In easyDITA, 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 source 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.