1. Knowledge & Support
  2. System Administration

Creating New Translations

Key Concepts

The PlanetTogether APS software is available in multiple languages. This guide is intended to provide advanced information for language translators, in the case where a client may require the software to be translated into an unavailable language.

Language text is stored in .Net resources files and compiled into the system.  However, it is possible to create temporary resource files that can be used during the translation process to avoid the need to create a new version of the software to test a new language resource file.

There is a Localization folder created at: [Program Files]APSLocalization.  This folder can be used to store temporary language files as described below.

These are the steps to follow to edit a resx file:

1.    To use a custom resource file for text instead of the embedded resource files:

2.    Edit the PTStrings.<language>.resx file

3.    Run Resgen.exe (part of Microsoft Visual Studio) to create a .resources file for the PtStrings.rex file.

For example: resgen.exe PtStrings.resx PtStrings.resources

4.    Run Resgen.exe to create a .resources file from the modified resx file:  (Do this each time you modify the resx file.)

For example: resgen.exe PtStrings.<language>.resx PtStrings.<language>.resources

5.    Start the APS client.  It will load the PTStrings.<language>.resources file if found in the Localization folder.

6.    Note that the PtStrings.resources file created in step 2 MUST be in this folder along with any foreign language resources file created.

Note that this is designed for use by developers when creating alternate language files.  Changes made here will NOT affect remote clients, just the server.

For these files to affect clients they would have to be installed on the client computers too by adding them to the ClientUpdater.config file.