Ektron CMS400.Net Reference

>>Working with Multi-Language Content > Translating the Workarea

Translating the Workarea

When Ektron CMS400.NET is delivered, the Workarea is in English. If you want to translate it to another language, read this section.

Note: Ektron provides American English strings in a text file. You must translate them.

Prerequisites

The alphabetical, four-character identifier of the country/ language into which you are translating. See CultureInfo Class from the MSDN Web site (http://msdn2.microsoft.com/en-us/library/system.globalization.cultureinfo(vs.71).aspx).

The server that hosts Ektron CMS400.NET must have Visual Studio.NET

Procedure for Translating Workarea Strings

All Workarea text (that is, screen titles, Workarea menus, messages, alt text for buttons, etc.) is stored in a resource file. Resource files are installed to the siteroot\Workarea\resources directory.

Note: Workarea images that include text are stored in the workarea/images/language folder. For example, Workarea\images\french_standard.

Ektron CMS400.NET provides a resource files for the following languages. The English resource file is complete. The others are partially complete.

German

English (United States)

Spanish

French

Italian

Dutch - Netherlands

Dutch - Belgium

Regardless of the list above, to translate your Workarea, translate the English file into the desired language.

Procedure Overview

A resource file is not human-readable. To make it so, use Microsoft’s resgen utility. Next, translate the human-readable, .txt version of the file. Here is a portion of it.

add menu title=Add Menu

lbl ad serverip=Domain Controller IP

alt: remove collection items text=Click here to remove items from this collection

Notice that, for each string in the file, an English description appears first. The description includes information about where the text appears. For example, btn text appears on a button. Next is an equal sign (=), then English text.

Translate the text to the right of the equal sign. You can send the file to an agency or do it yourself.

Then, run the resgen utility on the .txt file again, indicating the translate-to language. This converts the file back to a machine-readable format. Finally, move that file to the appropriate language folder under workarea/images, and enable the new language in the Workarea.

Step by Step Instructions

To perform this procedure, follow these steps.

1. The resgen.exe utility is located in C:\Program Files\Microsoft Visual Studio 8\SDK\v2.0\Bin. Copy it to the your web site\Workarea\resources folder.

2. Go to Windows Start button > Microsoft Visual Studio 2005 > Visual Studio Tools > Visual Studio 2005 Command Prompt to open a command window.

3. Within the command window, change the directory to the your web site\Workarea\resources folder. For example, cd C:\Inetpub\wwwroot\CMS400Min\Workarea\resources.

4. Insert the following text: resgen EKResource.en-US.resources anyfilename.txt

Note: You can assign any name to the .txt file.

5. A .txt file of resource strings converted to a human-readable format is created in the resources directory. (You assigned its name in Step 4.) Open the file.

6. Replace any single backslashes (\) with a double backslash (\\).

7. Translate the text following every equal sign (=). Be careful not to change any occurrences of n surrounded by double backslashes (\\n\\).

Note: You can send the file to a translation house or translate the strings yourself.

8. Save and close the .txt file.

9. Open the command window (as described in Step 2) and insert the following: resgen anyfilename.txt EKResource.two-character country code-two-character language code.resources

Replace anyfilename.txt with the file you named in Step 4. In this example, the .txt file is named span_translation.txt.

For example, to indicate that the Workarea is being translated into the Spanish/Spain, enter resgen.exe span_translation.txt EKResource.es-ES.resources.

When the conversion is complete, Writing Resource File ...Done appears in the command window.

10. The Workarea\resources folder includes several resource files. If one exists for the translate-to language, it is overwritten. If one does not exist, it is created.

To follow our example, the EkResource.es-ES.resources file was updated with changes you made in Step 7.

11. Move the updated resource file to the appropriate language folder under Workarea/images. To continue our example, move the file to the Workarea/images/spanish_traditional_Sort folder.

If a folder does not exist for the new language, create one under Workarea/images.

12. Enable the new language in the Language Settings screen. See Determining Which Languages are Available

13. Make the new language the default language in the Configuration Setup screen. See Updating Setup InformationFields on the Application Setup Screen: Workarea Tab.


Visit the Ektron Dev Center at http://dev.ektron.com 1-866 - 4 - EKTRON

Ektron CMS400.NET Reference Version 8.02 SP1 Rev 1

Ektron Documentation,© 2011 Ektron, Inc.