WEBDEV Concepts

136 Part 4: Advanced concepts 3.2 Languages that use a specific character set If your site supports languages that use specific character sets (Greek, Russian, etc.), you must enter the translation of the different messages using these specific character sets. WEBDEV allows you to automatically manage the use of specific character sets in the editor. When the text cursor is located in the input area of a language that uses a specific character set, the corresponding input language (character set used by the keyboard) is automatically enabled. Therefore, if a caption is entered in the Russian section of the caption description, the keyboard will automatically switch to the Russian character set. Reminder: To use specific character sets, the files corresponding to the desired character sets must be installed in the Windows region settings (control panel). 3.3 Translating specific pages Handling HFSQL errors By default, HFSQL error management pages are provided in English and French. To translate them into another language, you must: 1.  Include the default error pages in your project. These pages are provided as examples in the "\ Programs\Data\Preset Pages\EN\HyperFileSQL - Automatic Help Pages" subdirectory. 2. Customize error handling to use HFSQL error pages (HOnError). 3. Translate the different messages (see previous paragraph). User Groupware By default, the User Groupware is available in English and French. To translate a site that uses the User Groupware, select the "Manual start" mode when integrating the User Groupware into the site. Reminder: To configure the User Groupware, go to the "Project" tab, "Project" group and click "User Groupware". The different pages of the User Groupware will be included in your project. Then, all you have to do is translate these pages. 3.4 Translating WLanguage code messages In your code, several WLanguage functions allow you to communicate with users via character strings. These messages must also be translated into the different languages of your site. To translate a character string typed in the code editor: 1. Select the character string to be translated. 2. Select "Translate" in the context menu of the selection. The window for translating messages is displayed. 3. Type the translation and validate. The line of code is displayed in the code editor: • The icon indicates that this string has been translated to other languages. Click the icon to open the translation window. • To see the existing translations, simply hover over the icon. Remark : To convert all the messages in your code into multilingual messages, go to the "Code" tab, "Languages" group, expand "Translate strings" and select "Convert simple strings into multilingual messages". 4 Choosing the language through programming A multilingual site is an application that can be distributed in several languages. The user will be able to choose the language used by the application at runtime. You can for example: • prompt the user to choose the runtime language the first time the application is started. • implement an option (menu option or button for example) allowing the user to change the current language of the application.