.: Translating SheetCam TNG :.
Home Features Downloads Plugins Support Purchase Contact Distributors Scanything Forum

SheetCam uses standard GNU Gettext message catalogs for it's translation. These instructions are designed for users who are not familiar with Gettext catalogs.

 First you need to install Poedit. This is freely available from http://www.poedit.net in both Windows and Linux flavours.

Creating a new translation

Note this only has to be done if you want to create a completely new translation. If you just want to edit an existing translation you can skip this section

Run Poedit and go to File->new catalog form pot file. Open {install_folder}/Languages/messages.pot. A box will appear asking for some settings. For the team details enter your name and email address. The charset used us UTF-8. Ignore the paths and keywords tabs.

When you click on ok you will be asked where you want to save the translation. Create a new folder with your language code. These codes correspond to the ISO639-1 standard language names. You can find a list on Wikipedia. Save the file as messages.po in that folder. Skip down to editing a file.

Opening a translation file

Run Poedit and go to File->Open. Using the dialog that appears, go to {install_folder}/Languages/. In that folder you will see a number of folders with two letter names. These codes correspond to the ISO639-1 standard language names. You can find a list on Wikipedia. Go to your selected language and open the messages file. It is quite likely that the file may be out of date so go to Catalog->Update form POT file. Open messages.pot form the Languages folder. A message box will then appear showing you the changes, if any.

Editing a translation file with Poedit

 Now you have a language file open you will see a list of all of the strings that need translating on the left and all of the translated version on the right. At the bottom of the window is a box for you to edit the translated string.

Note that a few special codes are used in some of the strings:

For instance Registered to: %s will display the text 'Registered to' then the user's name.

Once you have finished editing, save the file and restart SheetCam for your changes to take effect.

 

A note about install folders

Different version of Windows and Linux store the SheetCam files in different places. Most commonly under Windows, {install_folder} will be something like:
c:\program files\SheetCam TNG

 Under Linux it will probably be something like:
/usr/share/SheetCamTNG