Translating an Application (ResourceBlender Express)
Click Resources from the main menu to select specific bundles and languages to edit. Alternatively, all languages or just the default language can be edited directly from the resource summary by clicking the corresponding buttons.
Before starting a translation, you should read Understanding Bundles and Elements.
Editing RBT Files
See Editing RBT Files.
Adding an Element
To add a new element, click Add. The element name, bundle name and a translation into the default language are the only compulsory fields.
Clicking the Open full editor button next to a field will open a larger window allowing more room when editing text.
The resource used for an element can be changed using the Resource ID drop down box. Only resources where a translation into the default language of the application being edited is present are shown, as the default language is required for every element in a bundle.
Adding Elements in Bulk
Elements can also be added in bulk, saving time when adding multiple elements at once.
- From the View Resources dialog, select Element->Bulk Add Elements or press Ctrl+Shift+B.
- Enter each string from the application being translated on a new line.
Each translation entered is added as an element to the selected bundle. If the translation exists as a resource, the existing resource is used. If not, a new resource is created for each element.
If you enter:
- The space shuttle Atlantis has landed in California, where it was diverted after continuing stormy weather prevented a Florida touchdown.
- Atlantis landed at 1539 GMT at Edwards Air Force Base.
- Officials had aborted Saturday's planned landing at the Kennedy Space Center for the second consecutive day.
- The seven astronauts on board Atlantis have taken part in an ambitious and risky mission to service and re-fit the Hubble telescope.
- Nasa said that weather conditions over Florida forced flight controllers to give up on Sunday's first landing opportunity at Kennedy Space Center.
Elements are created with the following names, and the resources are added to them in the language you choose.
One Click Automatic Translation
The text for the default language can be quickly translated by clicking the Translate button. This uses Google Translate to translate whatever is entered for the default language for the resource being edited.
Bulk Automatic Translation
Elements can be filtered by bundle name, element name, comment contents or a translation. This is useful to prevent creating duplicate elements in an application. For example, a filter could be applied to show elements where the English translation contained New to quickly find any existing matching elements.
Click the Filters button to show the filters section.
When adding elements to a bundle, sometimes multiple elements use the same resource. To find the resource quickly, enter part of the translation into one of the language text boxes, Search button.
The Find Resources dialog will open, allowing you to search for resources where the translation into a selected languages starts with, ends with or contains a word or phrase.
Eg: If you enter a translation into the box for French, for example, matching translations in French will be shown.
A list of matching translations will be shown, and clicking one will select it from the Resource ID dropdown box and populate the boxes with available translations.
The element comment is optional and can be used to give context to an element such as The save button in the main menu or The window title when exiting. The resource comment is optional and gives context to the resource in general, while each translator's comment gives context to the translation into a particular language. This is never used when generating resources except for the PO format, where it is used to store the meta data for each entry.
When ResourceBlender generates resources, if a translation into the target language is available it is used, otherwise, the default language is used instead. Therefore, if no translation is available you should leave the textbox for that language blank and not copy and paste the default language.
When editing, the following shortcut keys are available:
|Alt + Left||Previous Element|
|Alt + Right||Next Element|
|Ctrl+ S||Save and close|
|Escape||Close without saving|
|Ctrl + 1 to Ctrl + 9||Select Translation 1 - 9|
Creating variants of existing translations
Editing PO Files
See PO File Editor