This article will guide you though how to create a translation of a document version using the XLIFF approach. For a high level overview of the external translation feature, please refer to External Translation using XLIFF.

Prerequisites

Before you can import a document to XLIFF you need to have permissions to:

  • View, add, and delete pages.

  • Add and delete attachments.

1: Export a Document Version to XLIFF

The first step to external translation is to export an XLIFF file of the source language.

Step 1: Navigate to the Document Manager

To find the Document Manager you can: 

  1. Click Scroll Documents from the Apps section in your space sidebar.

  2. From the Document Library, click the document card of a document.

Or

  1. From a page in a document, click Document toolbox and click the cog icon.

Step 2: Download the XLIFF File

To download the XLIFF file, see the steps below:

  1. Locate the version you would like to translate and select Add translation.

  2. Select XLIFF Translation and click Next.

  3. Select the Source language.

  4. (Optional) Select the Target language.

  5. Click Export.

2: External Translation

Once the XLIFF ZIP file was downloaded in the previous step, you can submit it to your translation provider. Once they are finished translating the files, they will return the individual XLIFF files to you, with the translations added. If the files you receive from your translation providers aren't in a ZIP archive, make sure to zip them before uploading.

Make sure you create the ZIP with only the individual XLIFF files within it. When on MacOS, hidden system files can be included in the ZIP archive by accident. Learn more on how to prevent that.

3: Import a Document Version from XLIFF

The last main step is to import the translated XLIFF back into Confluence. 

Step 1: Navigate to the Document Manager

In order to navigate to the Document Manager you can either:

  1. Click Scroll Documents from the Apps section in your space sidebar.

  2. From the Document Library, click the document card of a document.

Or

  1. From a page in a document, click Document toolbox and click the cog icon.

Step 2: Import the XLIFF File

To import the XLIFF file, follow the steps below:

  1. Locate the version you would like to translate and select Add translation.

  2. Select XLIFF Translation and click Next.

  3. Select Import XLIFF.

  4. Drag & drop the the ZIP into the area or click the area to select the file.

  5. Select the Target language.

  6. (Optional) Adjust the prefix.

  7. Click Next.

  8. Check the target language, version and the number of pages.

  9. If everything is correct, click Import and Create.

Your target language translation has been successfully created.