Localizing GlobalSight

From SpartanWiki

Jump to: navigation, search

The strings that are used in GlobalSight's UI are externalized, allowing the UI to be translated into other languages. Most of this information is based on a walkthrough by Donald Pan of Welocalize. It may be included in a future version of the documentation.

Enabling Access to the Language Configuration

The UI Locale can only be managed by the superadmin, and only if the "Locale Language" permissions are enabled. By default, they are disabled, so you will need to turn them on:

1. Log in to GlobalSight as the superadmin and go to Setup > Permission Groups.

2. Select the SuperAdministrator Permission Group and click 'Edit'

3. Click Permissions

4. Expand the Setup category and check the Locale Language group:

Image:Localize_permissions.png

5. Click Done

6. Click Save

Access to the UI Locale Settings are now enabled. However, you will need to log out of GlobalSight and log back in before the Setup menu will show the Language Configuration item.

Managing Language Configuration

As superadmin, you can now navigate to Setup > Language Configuration:

Image:Language_config1.png

In this UI, you can manage the installed localization bundles and create new ones.

  • "New" is to add a locale to the system and clicking it will go to the New Locale Language page which includes a drop down list for user to select a new locale language (background operation should include creating a resource file with English text in it by default)
  • "Remove" means deleting the selected locale language from system. Needs to re-start GlobalSight for this to take effect.
  • "Set as Default" means setting the selected locale language and make it the default locale language displayed in GlobalSight.
  • "Download Resource" provides the function of downloading the selected locale language resource file from GlobalSight for translation.
  • "Upload Resource" uploads the translated resource file back to GlobalSight for the text translation update. Needs to re-start GlobalSight for this to take effect.

To change the default UI locale, select an entry from the table and click Set as Default. You will need to restart GlobalSight for the changes to take effect.

Currently the default UI locale is a global setting. There is no way to display a different UI locale per-user or per-company. However, users may select a non-default UI locale on the login screen, from any of the installed language choices.

Image:Login_language.png

Adding a new language

In the Language Configuration dialog, you can upload localized properties files for a new locale by selecting the Locale you are localizing into and clicking Upload. You will be prompted to upload a properties file or a zip containing multiple properties files.

Note: During the uploading operation, a step of native2ascii encoding conversion is done for the internationalization. So the encoding of the translated property files needs to be selected or entered first. This is shown in following screenshot's "File Encoding" area:

Image:Language_config2.png

Retrieved from "http://www.globalsightsaas.com/wiki/index.php/Localizing_GlobalSight"
Personal tools