15 August 2011 Language Translations

CamBam is being translated to a variety of different languages. This plugin can be used to modify the language data files, which contain translations for text used within the main CamBam application.

See also : CamBam Language Translation Reference

Download

download Translations.zip (182 KB)

Installation

To install the plugin, unzip Translations.dll into the CamBam plugins folder.
The GoogleTranslateAPI.Net20.dll and Newtonsoft.Json.Net20.dll files need to be copied into the parent folder (ie, where CamBam.exe is located).

If the installation is successful, you should see a new entry: Translations in the CamBam plugins menu.

Usage

Selecting the Translations plugin menu shows a table of the translation information. The right most column is the translation and can be modified directly in the table. Double clicking a value will open up a multi-line text editor which may be easier.

If the translation value is blank, this entry will need an entry adding. In these cases, CamBam will use the English phrase. The Flag Untranslated tick box at the bottom of the plugin form will prefix the unstranslated English with an exclamation mark '! ', which can make it easier to spot text that still needs translating in the user interface.

Right clicking the table shows a context menu:

• Google Translate (Selected Only) - will translate the currently selected row only (and overwrite any existing value)
• Google Translate (All) - will translate all entries that have a blank translation.
• Cache all Resource Strings - populates the translation data table with many strings used within CamBam.
• Clean Resource Strings - removes duplicate translation entries that are the same as resource string translations.

NOTE: The automatic Google translation options sometimes fail if you exceed their useage limits. If this happens, press continue and try again later.

The translation table can ‘learn’ new phrases. If CamBam encounters a translation request it hasn't seen before, a new entry will be added to the table with a blank translation.

If you change the translation table, some text (such as menus) won't change immediately and will only be updated when CamBam is restarted. Changing the 'Flag Untranslated' marker may also need a restart to take effect.

The translation tables are saved when CamBam closes, or when Tools - Save Settings is used. You can find the data files using the Tools - Browse system folder menu option. The data files are backed up before overwriting by CamBam, but it would be a good idea to take backup copies if you are doing a lot of changes.

The language data files are tab delimited text files.
The first row is a header row.
Each following row contains three columns:
Column 1 is a key value. This may be an English phrase or an identifier used in the program.
Column 2 is the English expression. If this is blank, the English expression is the same as the key value.
Column 3 contains the translated phrase.