Difference between revisions of "Pootle User Guide/Offline Translation"

Revision as of 10:43, 22 August 2013

>]]

Download Files

Before starting to translate offline, you should make sure to coordinate the translation activity with your team.

If you want to translate offline, you need to download the files from Pootle and to upload them once translated. These options are available on the "Overview" tab page.

You can download either the complete project files, or by folder, or single files. First select the folder in the tree-view on the left side of the "Overview" tab page, so that you see the content of the folder. Then click "Download". You need to wait a little bit, because the .zip file is generated on demand. In the situation shown in the picture you would get a file aoo40help-de-helpcontent2-source-text-sdraw.zip. Notice that the file name contains the path as it is shown on the picture.

Work Offline

You can work with a preferred editor. Most commonly used editors by community are:

• Poedit

• OmegaT

If you want to work with only fuzzy/untranslated strings, an extra step is needed to filter those strings from downloaded .po file.

• Run pofilter which is a part of Translate Toolkit. You can download Translate Toolkit from here
  • pofilter -t isfuzzy -t untranslated <input file> <filtered file>

This will extract all strings which are fuzzy or untranslated.

Once you finish working in filtered po file, you can merge it back into the original file using pomerge before uploading to Pootle.

Upload Translated Files

Once translation is completed, you need to upload your work to Pootle.

There are three options of upload. Anyone has the option "suggest", logged in users have the additional options "merge" and "overwrite".

suggest

All changes are treated as suggestions.

merge

Default option for logged in users. Previously untranslated strings are submitted and the modifications of already translated strings are marked as 'suggestion', which means they need a review before submission. If you make some modifications to existing translations (e.g., bug fixing), please make sure that they are reviewed and accepted by reviewer. Unless, the modifications won't be applied.

overwrite

The uploaded file overwrites the existing file on Pootle. This option should be carefully used as it has possibility to loose existing data. If you make sure all the contents of your file are valid, you can choose 'overwrite' option for quick upload.

Note: During uploading, you should make sure that you're located in the right folder. You should upload a .zip file in the same folder that you downloaded it from. If you upload a file to a wrong location, please contact a Pootle administrator.