GSoC 2010/Projects/transifex-mobile/manual

Contents

Intro

Transifex-Mobile is a mobile localization application linked to translations portal Transifex.net.

Installation

  • Start Application manager
  • Enable Maemo Extras repository
  • Tap on "Download"
  • Tap on "Development"
  • Tap on "Transifex-mobile" to install it
  • Icon with title "Transifex-Mobile" should appear in the menu, use it to run the application

Usage

Icon

After installing the icon should appear in the menu, tap it to start the program

Image:Transifex-mobile-menu-item.png

Dashboard

The main screen mimics Transifex's dashboard view. The user can see her locks there, browse projects etc. Left-top button shows user's first and last name plus e-mail address. Verify that those are correct before pushing any files back to server. PO-file metadata is updated based on this information. Editing local PO-files is also enabled, just tap on "Open local file" in the menu.

Image:Transifex-mobile-dashboard.png

Projects

Browsing projects is rather straightforward, to search tap on "Search" in the menu.

Image:Transifex-mobile-projects.png

Files

Each component in a project contains files, or translations to be more abstract. File list view shows progress for each file.

Image:Transifex-mobile-files.png

Strings

Each file contains a set of strings. In the left-bottom corner there are some buttons for filtering. A string can have three statuses - green means translated string, red means not translated and blue is used mark fuzzy strings, this means that the string is basically translated but might need to be checked one more time.

Image:Transifex-mobile-strings.png

String editor

String editor view provides all the things you need to translate one string. With the buttons on the bottom user can navigate through strings in the current stringset, revert back to the original one, copy source string, use Google Translate to automatically translate the string and finally set the string status either to translated, fuzzy or untranslated.

Image:Transifex-mobile-string-editor.png

Push dialog

Upon closing the string list view user is confronted with push dialog. Here user can select whether changes are to be pushed back to server, or to be forgotten. Remember to unlock the file once you have finished translating.

Image:Transifex-mobile-push-dialog.png

Debugging

To start Transifex-Mobile in debugging mode, fire up terminal and execute following command:

/opt/transifex-mobile/main.py -d

Transifex-Mobile configuration file is located at:

~/.config/transifex-client.json

Cached PO files are stored in:

~/.cache/transifex-mobile

You can report bugs in this Maemo Talk thread, please include debugging output.