ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

This content has been translated automatically.  Click here  to view the French version.
Help / Tools / Translation tools / WDTrad
  • How to translate a text file with WDTRAD?
  • How to find a message in WDTRAD?
  • How to force a keyboard to enter text in WDTRAD?
  • Notes
  • Specific characters in messages (framework libraries, programming messages, etc.)
WINDEV
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
Others
Stored procedures
How to translate a text file with WDTRAD?
To translate a text file with WDTRAD:
  1. Select the source language (language in which the text was extracted) and the target language (language to which the text must be translated).
    Note: If the translation language is a custom language, select the "Custom language" option and enter the language features (keyboard, set direction, etc.)..
  2. In "Reference", select the file that contains the messages to be translated. This file can be:
    • a text file (".txt" extension).
    • an HFSQL data file (".fic" extension).
    • a WDMSG file (".wdmsg" extension).
  3. In "Translation", select the translation file. This file can be:
    • a text file (".txt" extension)
    • an HFSQL data file (".fic" extension).
    • a WDMSG file (".wdmsg" extension).
  4. Select the dictionary to use. This dictionary contains the existing translations.
    WDTRAD is supplied with a French/English dictionary containing over 6000 messages.
  5. If WINDEV, WEBDEV or WINDEV Mobile is installed on the computer, select the project that contains the text to translate (Project" option under the dictionary path). If the project is selected, you will be able to view the text in the corresponding IDE ("View in project" in the context menu of the message).
  6. Click "Load" to display the content of the selected files. The "Reference" column displays the extracted text. The "Translation" column displays the translated text to be reintegrated. Each row in the table represents a text resource.
    Remark: The Color of Background of untranslated messages is orange.
  7. Click "AutoTrans". All "Reference" expressions found in the dictionary are automatically translated.
  8. Select a row and edit the translation if necessary.
    Note: If changes are made to the reference file, it will be necessary to reintegrate this file into the original WINDEV, WEBDEV or WINDEV Mobile application using WDMSG.
  9. Click on the magnifying glass in front of the message: a window opens showing the context of the resource to be translated.. The control being translated is highlighted with a red border.
  10. Double-click the resource (or click "Find"). The different translation suggestions appear in the dictionary results. Translations are sorted by relevance. The icon on the left of each translation indicates the degree of relevance.
    Remark: WDTRAD automatically reconstructs a translation when a close match is found.
  11. Double-click the desired translation. The translation is automatically copied into the "Translation" column of the current resource.
    Note: If there is no suitable translation, enter the desired translation in the "Translation" column of the current message.. To add this new translation to the dictionary, select "Add to dictionary" in the context menu of the resource.
  12. Repeat steps 8 to 10 for all the resources you want to translate.
  13. Click "Save" to save the reference and translation files.
Remarks:
  • To view long resources and/or resources in RTF, select "View in form mode" in the context menu of the resource.
  • The file containing the translated resources:
    • can be printed for proofreading ("File .. Print").
    • can be integrated into the project using WDMSG or WDINT.
  • WDTRAD offers two methods to copy extracted and translated text. For more details, see the Copy modes.
  • To configure the dictionary (add, modify or delete resources), select "Dictionary properties" in the context menu of the dictionary results. For more details, see Dictionary properties
  • To configure WDTRAD, select "Edit .. Preferences". The details of these options are presented in WDTRAD options.
  • WDTRAD allows you to differentiate translations by supporting multiple locations. For example, you can set a "Commercial" location to group translations of commercial documents, and an "Interface" location to group translations of elements from the interface. You can choose the location during the translation process and when adding an element into the dictionary.
    To create new locations, select "Edit .. Edit the locations".
  • You have the ability to configure the characteristics of each language: keyboard used, symbols. For more details, see Dictionary properties.
  • Some translated resources (automatic translations, for example) may be displayed on an orange background. This might seem to indicate that the resource was not translated. A specific algorithm determines whether or not a resource has been translated:
    • One-letter words are considered valid translations if they are identical.
    • If the "Considered as translated when identical" option is enabled, resources are considered as translated if the translation is identical to the reference.
    In all other cases, a ratio is calculated between the number of words in the reference text and in the translation. If this ratio is below a dynamically defined threshold, the resource is not considered as translated. Besides, the resource is considered as translated only if the number of lines is the same both in the reference and target texts.
How to find a message in WDTRAD?
To find a message in a file opened in WDTRAD, you can:
  • sort messages alphabetically: click on the column header.
  • sort messages by type: click on the "Type" column header.
  • filter to display only lines marked with a label: click on the label picto in the "Type" column and select the label to filter. To delete the filter, select "Cancel filter" in the menu displayed by the icon.
  • perform a simple search: click on the icon in the column header and enter the start of the message you are looking for.
    Note: This search can also be performed on resources found in the dictionary.
  • use a filter: right-click on the magnifying glass in the column header and select "Filter" with the filter description. Enter the filter condition in the column header: only the corresponding lines will be displayed in the table.. To delete the filter, select "Delete filter" in the context menu of the column.
  • do an advanced search: use the Ctrl + F key combination and enter the search parameters:
    • The text to search for,
    • The text that will replace the text you are searching for (if necessary),
    • The language in which the search must be performed,
    • The characteristics of the search ("whole word only", "case-sensitive", "loop").
    Use the "Next", "Replace" and "Replace all" buttons to search and replace.
To perform a search the WDTRAD dictionary, you can:
  • Use the search box displayed below the list of resources. Simply type the desired text, choose the target language, and click "Search".
  • Use the "Search" tab in the dictionary properties. For more details, see Dictionary properties.
How to force a keyboard to enter text in WDTRAD?
WDTRAD automatically changes the keyboard and character set according to the language. This mechanism enables input in languages using specific keyboards and character sets (Russian, Chinese, Japanese, Arabic, Greek, etc.).
This also switches the keyboard to a QWERTY layout when entering text in English. To enter text in English using a French keyboard (AZERTY), you must change the keyboard associated with the English language in Windows:
  1. Open the WDTRAD settings ("Edit .. Preferences").
  2. Select "Automatically change keyboard language" and "Automatically install missing keyboards" if necessary. This option allows you to install and enable missing keyboards.
  3. Confirm the WDTRAD settings window.
Notes

Specific characters in messages (framework libraries, programming messages, etc.)

Some messages include:
  • Strings such as %s, %1, %2, %1!d!, ...
    These strings represent parameters in the text. At runtime, these strings are automatically replaced with a file name, a directory name, ...
    These strings must not be modified or deleted in the translation. However, you can change the position of these strings within the text.
    For example, the message "Error in %2 process, line %1!d!" will be translated as "Erreur à la ligne %1!d! du traitement %2.".
  • Strings such as [%xxxx%]
    These strings represent parameters in the text. At runtime, these strings are automatically replaced by the contents of a variable, etc..
    These strings must not be modified or deleted in the translation. The content of these strings must not be translated. However, you can change the position of these strings within the text.
    For example, the English translation of the message "Confirmez-vous la création du client: [%sCustomerName%]" should be "Do you confim the creation of the customer: [%sCustomerName%]".
  • Strings such as \t, \n, \r.
    These strings are used to format messages (tabulation, line feed, etc.)..
    These strings must not be modified or deleted in the translation. The position of these strings should not be changed.
    For example, the English translation of the message "Impossible to open xBase file <%1!s!>.\r\nError code returned by xBase DLL: %2!d!." should be "Unable to open xBase <%1!s!> file.\r\nError code returned by xBase DLL: %2!d!.".
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 09/14/2024

Send a report | Local help