This feature is available from the Essential plan and above.
In Lokalise, with the new document file support, you can upload, translate, and download DOCX, PPTX, IDML, and HTML files.
This project type helps translate emails, articles, user guides, legal documents and ad-hoc content snippets.
Index
Project type differences
The document-type project editor differs from Lokalise’s software localization project editor. Here is the list of differences:
The editor allows previewing of translations in the file.
The editor has a header that separates the keys of each file.
Layout, formatting and embedded images are preserved.
Separate keys are created for each text unit: headers, paragraphs, etc.
The editor can't add new keys/paragraphs or remove the existing ones. Layout changes should be done in an original file and then uploaded again to Lokalise. Translations will be restored from a translation memory.
Keys are displayed in the same order as in the uploaded file, the editor does not have sorting for document file types.
Integrations with content management systems are not available.
Key name, description and other properties cannot be changed.
Getting started
To get started, open your projects dashboard and create a new project with the Documents type:
Also enter the project name, choose the base language (the one you'll be translating from) and one or more target languages (the ones you'll be translating into). Once you are ready, click Proceed.
Now you can upload your documents to the project!
Uploading the documents
Open your newly created project and proceed to the Upload page. Choose a file you want to upload and adjust the uploading options:
Please remember that in document files, headers and paragraphs are accounted for as keys. In other words, one paragraph = one key.
Editor overview
The project editor allows you to add new languages, perform translations, and preview files.
Each file is represented by a header and related keys. Editing, searching, and applying bulk actions is possible across multiple files simultaneously.
Files are ordered by the upload time (the most recent files are shown first). Keys have a fixed order and are sorted the same way as they appear in the original file.
Selecting files for the editor
Click the Files button in the top menu to open the Files widget.
Here you can:
Select which files should be currently visible in the editor.
Delete files from the project.
Please note that it will take several seconds to delete a file and no progress indicator will be shown.
Search for specific files.
Sort files in the file selector.
Please note that this sorting won't be applied to an order of files in the editor.
Previewing files
Previewing HTML files
You can preview HTML files by clicking the Open preview link in the file header:
A new window will be opened and the HTML file with the complete layout, styles, and images will be displayed. Please note that no scripts will be executed in the preview, so content hidden in sliders or collapsible panels may not be visible in the preview.
You can see how translations would look in the file by changing the language in the dropdown within the preview window. Untranslated parts of the file would contain the value of the base language.
The best result can be achieved if styles and images are either inlined or have absolute links.
Previewing DOCX, PPTX, and other non-HTML files
To preview non-HTML files, switch to the Bilingual mode and click Download file:
This will download a translated file for preview. If keys are empty, then a base language value would be inserted into the target file (so you can preview an original file by downloading a target file while all keys are empty).
Download file button is disabled by default but you can enable it in the project settings. To achieve that, click More > Settings, proceed to the Quality assurance section, and tick the Allow contributors to download target files for preview checkbox:
Project dashboard overview
Document type projects are displayed in a very similar way to software localization projects. In the dashboard you can see the overall progress of your project as well as that of the languages. Yet, there is a small change: you can track the progress of each document in the project separately. On top of that, you can rename and remove individual documents:
Images and layout
Our platform allows you to upload documents without altering the document structure. Complete file layout and all images will be uploaded to Lokalise even though they will not be displayed inside the editor. You will get the translated document with layout, formatting and images back when you export the file.