Skip to content

Latest commit

 

History

History
27 lines (23 loc) · 2.66 KB

Offline-translation-features.md

File metadata and controls

27 lines (23 loc) · 2.66 KB
Raw

These features address an issue that was preventing projects that did not originally use .po format from being translated offline as .po files. Documents could be downloaded as .po but would not work properly during upload (see [[bug 870876 | https://bugzilla.redhat.com/show_bug.cgi?id=870876]]).

To translate offline:

  1. navigate to the project-version of interest, e.g. https://translate.zanata.org/zanata/iteration/view/zanata-server/master
  2. make sure you are signed in
  3. find your language in the table, and click the page icon in the "Documents" column, which goes to something like https://translate.zanata.org/zanata/iteration/files/zanata-server/master/en-GB
  4. At this stage you may see one of a few things:
  • if the Zanata server has not yet updated to 2.3, there will be no link for config file under "Actions" and the remainder of these instructions are probably not useful
  • if the project type is not set, you should see "Config File" and "Download All Files" under "Actions", but they will be disabled - the project maintainer needs to set the project type before you can continue with these instructions
  • otherwise, the Config File and "Download All Files" links should be enabled
  1. If the links are enabled, choose one of the following:-
  • If you want to translate a single file, use the .po link for that file in the table (this will be disabled under the same conditions that the config and zip are disabled). After translation, use the "upload" link in the "Actions" column next to the same document.
  • If you want a zip containing a config file and all the documents, see "Zip Download" below.
  • If you want to use one of the clients, see "Download with Client" below.

Zip Download

  1. Use the Download All Files link, save the zip and extract to the desired location. The zip contains a config file that will be set to use project type 'offlinepo' if it is needed, and po files will use a special mapping if necessary.
  2. Translate .po files as normal.
  3. Use the [[Java Client | Zanata-Java-Client]] or [[Maven Plugin | Zanata-Maven-Integration]] to push the translated files back to the server.
  • Documents may also be uploaded individually using the "Upload" action in the table on the Documents page.

Download with Client

  1. Click the Config File link and save zanata.xml to the directory you will work in. The config file will be set to use project type 'offlinepo' if it is needed.
  2. Use the 'pull' command with [[Java Client | Zanata-Java-Client]] or [[Maven Plugin | Zanata-Maven-Integration]]. This will download .po files.
  3. Translate .po files as normal.
  4. Use the 'push' command to upload translations. You should use push type 'trans'.