Giving Back – Get Localization and Plan

Giving Back – Get Localization and Plan

Today we would like to tell you about a client that is especially dear to us. Since 2011 Plan Finland has been using Get Localization to coordinate their voluntary translation work. We actually started our relationship by offering them a slightly different service, but soon discovered together with the folks at Plan that the best solution for them is to use Get Localization to coordinate all translation activities of their volunteer translators.

But enough from me, now I’ll give the word to Plan Finland’s Lotta Kallio:

Plan Finland

Q1. Tell us about Plan!

Plan is an international development organization promoting children’s rights.  Plan has been operating in Finland since 1998. Plan International was founded in 1937. Today, around 30,000 people in Finland support our work. Plan is the largest organization practicing child sponsorship in Finland. Plan has no religious or political affiliations. Plan International works in 69 countries and runs development programs in 50 countries. There are fundraising national offices in 22 countries. In Plan’s world, human rights are respected and children realize their full potential as members of society. In addition to development projects and child sponsorship in developing countries, we also work on a national level in Finland, focus on corporate partnerships, advocacy work and communication.

Q2. Please tell us about yourself.

My name is Lotta Kallio and I work as a Sponsorship communications coordinator here at Plan Finland. I oversee the correspondence between our Finnish sponsors and sponsored children around the world. I also coordinate our office and translation volunteer workers.

Q3. How are you using Get Localization?

I’ve found that Get Localization is a very effective way to coordinate translation work to our volunteers. Documents are mainly Plan’s reports of sponsored children’s communities, overviews, annual reports, area updates etc. and the translation languages are English and Finnish at the moment. Get Localization provides a great way for our volunteers to do work from home, it’s easy to access and user friendly. Also, the translation memory is a great feature when the documents have similarities in structure. Loading the documents is simple to and from the program.

Q4. Do you have translation tips or best practices you would like to share with other NGOs?

Our volunteers have been very pleased with this program. Because the documents are “cut” in smaller fragments, a person can translate a few lines at the time so there’s no pressure of having to translate a whole document in a certain timeframe. I’ve found that this encourages our volunteers to do more translation work than via e-mail.

We want to thank Lotta for taking the time to inform our readers about Plan and their experiences with Get Localization! It’s our pleasure to help.

To all our readers, please check out the Plan website. Maybe it could be something for you too? If you want to know about other ways the localization and translation industry is giving back to society, you can check out Translators Without Borders.

Apps Localization for Nokia Series 40 and Asha

Apps Localization for Nokia Series 40 and Asha

700-nokia_301_dualsim

We have recently added support for the Nokia Java SDK, which is an Eclipse based IDE for Java ME development. This post covers basics on how to get started with localizing your Java ME apps for multiple languages by using the Get Localization Sync plug-in and Nokia Java SDK.

Getting Started: Install Everything

If you don’t have the latest Nokia Java SDK, you can download it from http://www.developer.nokia.com/Develop/Series_40/.

Then you need the Get Localization Sync plug-in.

    • Open your Nokia Java SDK
    • Choose Help -> Install new software…
install
Installing the plug-in
  • Click ‘Add…’
  • Enter a name for the repository, e.g. Get Localization
  • Enter the repository location, which is http://getlocalization.sync.s3.amazonaws.com
  • Click ‘Ok’
  • Check ‘Get Localization Sync’ plugin
  • Click ‘Next’ and follow instructions

Internationalization

If you are not aware of the concept of internalization or I18n, please refer to our earlier blog post Software Internalization for Dummies. Java ME is one of those frameworks that are shipped without a standard internalization framework. Fortunately Nokia provides internalization support within their SDK and it’s easy to set up.

When you create a new project, you have an option to ‘Enable Localization Support’ (see screenshot below). This feature allows you to localize  your application strings easily.

enable_l10n_support
Screenshot #1

TIP: If you already have a project and/or an existing app, you can enable the localization support by right-clicking your project and selecting ‘Mobile Tools for Java’  ⇒ ‘Enable Localization’.

So now you have everything set up, let’s see what the SDK created for us:

created_files
Screenshot #2

As you can see, there’s now two new files inside the package that we defined in the previous step.

L10nConstants.java – This is a generated Java file and will contain all the metadata of your localization data.

L10nResources.java – This is a utility class for loading the strings inside your UI.

Then we got the new editor called Localization Data. This editor is used to manage all your application strings. First you need to add your first ‘locale’ i.e. the language your application will be translated from. We recommend writing the initial version in English, as it’s easier to find translators to translate from English than other languages. Click the ‘Add locale’ button and it will add automatically en-US language for you. Make sure to check ‘Default locale’ on for this language (you can find this option to the right). You can also modify the language and country code here if you want but it’s not necessary if your app is in English.

Next you can add your first entry. Entry is a string you are using in your application, let’s say you have a ListBox element and you are setting a title for it like this:

listBox.setTitle("My Awesome App");

Now, what you want is to add this very same text as an entry to the localization file. Click ‘Add entry’ button in Localization Data editor and define key for this entry e.g. LISTBOX_TITLE and then the value ‘My Awesome App”‘ Hit save and now a few things happened:

1. Inside the res folder you can find a file called messages_en-US.properties. This is a master file which will be translated into another languages.
2. L10nConstants.java was generated and updated.

This means that you can now modify your code to use these new classes.

First of all, you need an instance of L10nResources, for example:

L10nResources res = L10nResources.getL10nResources(null);

Given parameter is null here but you could also define language code here e.g. “en-US” or “fi-FI”. It’s good for testing purposes so you don’t have to change e.g. your emulator language. Giving null means that it will try to use the same language the device is currently using.

Now we can actually load the string from resources instead of hardcoding it:

listBox.setTitle(res.getString(L10nConstants.LISTBOX_TITLE));

That’s it. Now the text is always loaded from resource files based on the phone language.

Localization

That was easy. Now it’s time to start translating your app and for that Get Localization is the perfect companion. It is a browser based service that will help you manage the files, translate them and even let you to manage your own translators if you wish. This part assumes that you are familiar with Get Localization already. If not, then please  visit the frontpage, take a tour or if you have questions, create a support ticket in the ticketing system and someone will get back to you ASAP.

Configuring the Get Localization Sync Plug-In

First you need to configure your Get Localization Sync plugin. I hope you already installed it but if not, please refer to the section ‘Getting started: Install everything’.  Now in Package Explorer, right-click your project name e.g. MyApp in Screenshot #2 and select ‘Properties’. Then find Get Localization Sync leaf in your properties and you should see the below screen:

sync
Screenshot #3

The following fields are used:

Username – Your Get Localization username

Password – Your Get Localization password

Project – Your Get Localization project name (same that appears in project URL e.g. http://www.getlocalization.com/example/, where example is your project). If you don’t have project, please create one first at http://www.getlocalization.com/signup/

Default Platform – Platform you are developing on. IMPORTANT: You should choose “Java Properties (UTF-8)”

Pull file filter allows you to filter which files you wish to pull to your Eclipse project. For example just pull all the .properties files, you can use filter:

.*?properties

Replace rules can be used to alter file names when they’re pulled to project. Typically it’s not necessary but you can e.g. rename language codes in files in case they happen to be wrong.

Replace rules can be imported and exported so if you manage to do proper rules, please do share them with us. We’re happy to add them to our library.

Sending Files to Translation

Simply right-click the file in the res folder called messages_en-US.properties, then select ‘Get Localization Sync’  ⇒ ‘Send to translation’.

send_to

Syncing Translations Back to Project

When the files have been translated, you can sync them easily back to your project. Right-click ‘res’ folder and select ‘Get Localization Sync’  ⇒ ‘Sync translations to this folder’ and that is it.

sync_back

Localizing Your Other Data

Metadata such as Store Description

It’s highly recommended to localize your store description and other meta data. You can add multiple files to Get Localization so it’s easiest to add the store description e.g. as a plain text file. You can do this via browser on Get Localization project (Files tab)  or via the plug-in.

Dates and Times

Java ME does provide some help to localize dates and times. What you want to do is to provide them both in the same format based on user settings. These settings are already configured in the device and accessing them is easy.

Dates

You can get currently used date format using following piece of code:

String format = System.getProperty("com.nokia.mid.dateformat");

This method returns for example these values with following settings:

Gregorian calendar date in little endian format: dd-MM-yyyy

Gregorian calendar date in big endian format: yyyy/MM/dd

Gregorian calendar date in big endian format: yyyy-MM-dd

Note that the date separator can be often changed from the phone settings.

Time

In a similar way you can also get the time format which the Nokia Series 40 or Asha device is configured to use.

String timeFormat = System.getProperty("com.nokia.mid.timeformat");

In this case the return values are a bit simpler:

HH:mm means 24 hours clock

hh:mm a means 12 hours clock

Performance Updates

In an ongoing effort to speed-up the service, we have today added more extra processing power to the system and at the same time pushed out optimisations especially to the file management side. This means faster uploading / downloading and decreased processing times.

In case you face any problems with performance (or any other matter), please let us know by opening a ticket to our support system at http://support.getlocalization.com. Thanks!

Get Localization Sync for Eclipse

Get Localization Sync for Eclipse syncs your translation files between Eclipse and your Get Localization project. It’s very easy to use and allows developers to use their time to actual development instead of arranging and managing localization files.

Installing Get Localization Sync for Eclipse

Install from Eclipse Marketplace

Just select Help -> Eclipse Marketplace and search “Get Localization”

Install using “Install new software…” option

1. Choose Help -> Install new software…
2. Click “Add…” button
3. Enter name for repository e.g. Get Localization
4. Enter repository location, which is http://getlocalization.sync.s3.amazonaws.com
5. Click Ok
6. Click “Uncategorized” and check Get_Localization_Sync -plugin
7. Click “Next” and follow instructions

Setting Up Get Localization Sync for Eclipse

Settings are project specific and they can be easily found under your project properties.

Setting up Get Localization

In properties, you can find the Get Localization Sync plug-in.

Username – Your Get Localization username
Password – Your Get Localization password
Project – Your Get Localization project name (same that appears in project URL)
Default Platform – Platform you are developing on. It defines the file format of your i18n files. You can also set the format for individual files from their properties if you happen to have multiple different file formats in your project.

Sending Files To Translation

Right-click the file you wish to send to Get Localization and select “Get Localization Sync -> Send to translation”. Note that these always should be master files (files that translators translate from, typically in English), never send files that are in different language than your other master files.

Sync Translated Files Back To Project

After translation, you can easily sync the files back to any folder you wish.

Android Projects

Get Localization Sync for Eclipse handles Android projects specially when translations are synced back to “res” folder. They are automatically placed into appropriate values folders so they work in your application without any modification.

Update to Get Localization Sync for Eclipse

We’ve released a new version of Get Localization Sync for Eclipse. You can find it from Eclipse Marketplace, just search for Get Localization and install.

This update features couple of important new features:

Pull file filter allows you to filter which files you wish to pull to your Eclipse project. For example just pull all the strings.xml’s you can use filter:

.*?strings.xml

Replace rules can be used to alter filenames when they’re pulled to Eclipse project. You can for example create rules that change the language codes or installation path. E.g. if you wish to change language code from pt-BR to pt-rBR, just create following replace rule:

pt-BR/ -> pt-rBR/

Replace rules can be imported and exported so if you manage to do proper rules for example Android or some other platform, please do share them with us. We’re happy to add them to our library.



Microsoft Word DOCX Support Available

I’m happy to announce that we’ve added DOCX support to all projects starting from today. DOCX files can be imported under ‘Files’ -tab like any other file. Projects can hold multiple DOCX files and translation sync works between them and other files like before. It’s also possible to upload resource files and e.g. user manual to same project so everything will get translated at once.

Now additionally to websites and applications, we manage documents too. Yay!

How To Automatically Sync Master Files From GitHub

Some people have asked us how to setup an automatic master file sync from GitHub to Get Localization when commit is done. We’ve done a short video previously that explains it but here’s step-by-step instructions as well:

1. First import the file from GitHub to Get Localization. You can done this from Files → Import from SCM → GitHub

2. Select the file you would like to import to master files, typically it’s the English resource file.

3. Now as soon as file is imported successfully, go to your GitHub project and open ‘Admin’-page.

4. Click ‘Service Hooks’

5. Select ‘GetLocalization’ from the list of service hooks.

6. Enter your project name, it’s the same as in your Get Localization address e.g. http://www.getlocalization.com/<project-name&gt;. Also copy your project token from your Get Localization project settings page and paste it to corresponding project token field in GitHub.

66. 

7. Set project ‘Active’ and then click ‘Update Settings’

And that’s it. Now when you do the commit, all the files you’ve imported to master files will be automatically updated from GitHub.