Translate a Version Externally
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.
Navigate to the Document Manager
To find the Document Manager you can:
Click Scroll Documents from the Apps section in your space sidebar.
From the Document Library, click the document card of a document.
Or
From a page in a document, click Document toolbox.
Click on the cog icon.
Download the XLIFF file
To download the XLIFF file, see the steps below:
Locate the version you would like to translate and select Add translation.
Select XLIFF Translation and select Export XLIFF for translation, click Next.
Confirm the Source language.
(Optional) Select the Target language.
Select any labels that you would like to include or exclude from your export.
You can include and exclude labels as needed, by doing so, only the combination of labels selected will be exported. If you choose not to include or exclude labels then all pages will be exported.
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.
Navigate to the Document Manager
In order to navigate to the Document Manager you can either:
Click Scroll Documents from the Apps section in your space sidebar.
From the Document Library, click the document card of a document.
Or
From a page in a document, click Document toolbox.
Click on the cog icon.
Import the XLIFF file
To import the XLIFF file, follow the steps below:
Locate the version you would like to translate and select Add translation.
Select XLIFF Translation and click Next.
Select Import XLIFF.
Drag & drop the the ZIP into the area or click the area to select the file.
Select the Target language.
(Optional) Adjust the prefix.
Click Next.
Check the target language, version and the number of pages.
If everything is correct, click Import and Create.
Please note: if you selected specific labels to include or exclude during export, all pages will still appear upon completing the import action, regardless of your include/exclude selections during export.
Your target language translation has been successfully created.
Sometimes you might need to translate images between languages. When translating through XLIFF exports, all images are copied over from the author language. Therefore, if images need to be translated, you will need to translate these manually within Confluence.