Contents

1	PROLOC 2.6 FOR WINDOWS

1.1	About ProLoc 2.6 for Windows

1.2	About this Documentation

2	THE WINPROLOC PROGRAM

2.1	Menu Items and Options

2.2	Projects

2.2.1	Setup Project

2.2.2	Edit Project Entries

2.2.3	Open Project

2.2.4	Save Project

2.2.5	Save Project with Different Name

2.2.6	Exit WinProLoc

2.3	Localization

2.3.1	Extract Strings

2.4	Translate Text

2.4.1	The Translation Function

2.4.2	Translate Text Using a Textfile

2.4.2.1	Create Textfile

2.4.2.2	Edit Textfile

2.4.2.3	Update Database

2.5	Translating a Program

2.6	Applications

2.6.1	Reset Database

2.6.2	Fix Database

2.6.3	Evaluate Logfile

2.6.4	The File Manager

2.6.5	The Notepad

2.6.6	ASCII - ANSI Conversion

2.6.7	ANSI - ASCII Conversion

2.6.8	Changing the Editor


About WinProLoc

1.1  About Proloc 2.6 for Windows

Proloc 2.6 for Windows is a powerful tool for programmers and users who translate programs into different languages or test different descriptions of the same program.

Because of project oriented databases you only have to translate repeated text strings once. You can easily translate programs or test the wording consistency.

ProLoc 2.6 for Windows is a product of:

TechSys Consulting Inc.

300 Lenora St., Suite 254

Seattle, WA 98121

USA

Fax: (+1) (206) 281 8654

E-Mail 74551.3605@compuserve.com


About the Documentation

1.2  About this Documentation

This document explains the WinProLoc functions and how to access them using the mouse. The key combinations are shown in parenthesis. To use the keyboard, press and hold ALT, then press a letter key and release both keys.

Instead of menu bar selection, mouse users can select functions by clicking on the desktop items.


Menu Items and Options

2.1  Menu Items and Options

After starting Proloc 2.6 for Windows, the menu bar and your desktop items will be displayed. You can select the different functions from the menu bar or by clicking on the items on your desktop.


Projects

2.2  Projects

WinProLoc uses projects and automatically assigns each project its own project file. One is the database, which contains the texts and the translations. As you add text to this database, you will have less and less to translate. WinProLoc will then handle the translation. Therefore, it is recommended that you use the same database for each related project instead of using a different one for every project.


Setup Project

2.2.1  Setup Project

Before translating a program you have to open a project. If no project is available or you don't want to use one of the existing projects, you have to setup a new project. To do this, follow these steps:

1. From the menu bar, choose Project (or press ALT and P at the same time).

2. Choose New (ALT and N).

Or click on the Project item on your desktop and choose New (ALT and N).

The dialog box Project Information appears:

Complete each item of this window. To activate the boxes, ether select one box and click with the mouse or use the ALT key in combination with the hotkey (underlined letter):

1. Description: Enter a short description of the project. This is not the name that will be used to save the project! (ALT + D)

2. Source: Enter the language of the source textfiles (e.g.: German, English,...). (ALT + S)

3. Target: Enter the target language for the program. (ALT + T)

4. Environment: Select ASCII (ALT + A) if the source program uses ASCII format or select ANSI (ALT + S) if the source program uses ANSI format.

5. String Identifier: Enter the string identifier (e.g.: ' or ") which is used in the source program to indicate the beginning and end of the text strings (ALT + I).

To accept your choices, click OK. To change them, repeat the steps above.

After accepting all your choices, they will appear on your desktop.


Edit Project Entries

2.2.2  Edit Project Entries

To change the entries displayed on your desktop, follow these steps:

1.	From the menu bar, choose Project (ALT + P).

2.	Choose Update (ALT + U).

Or click on the Project item on your desktop and choose Update (ALT + U).

Now you can change the entries as shown in 2.2.1 .


Open Project

2.2.3  Open Project

To open an existing project, follow these steps:

1.	From the menu bar, choose Project (ALT + P).

2.	Choose Open (ALT + P)

Or click on the Project item on your desktop and choose Open. Confirm with OK 	(ALT + O).

Select one of your objects. Change directories by choosing Directories.

Choose OK (ALT + O). The object appears on your screen.


Save Project

2.2.4  Save Project

When finished working on one of the objects or to save changes (e.g. database changes) perform the following steps:

1.	From the menu bar, choose Project (ALT + P).

2.	Choose Save (ALT + S).

Or click on the Project item, choose Save (ALT + S) and then OK (ALT + O).

This will save the changes.


Save with Different Name

2.2.5  Save Project with Different Name

To do this, follow these steps:

1.	In the menu bar, choose Project (ALT + P).

2.	Choose Save As... (ALT + A).

3.	Enter the name. Change the directory, if necessary.

4.	Choose OK.

Or click on the Project item, choose Save As... (ALT + A) and then OK (ALT + O).

This will save the project with the new name.


Exit WinProLoc

2.2.6  Exit WinProLoc

1.	From the menu bar, choose Project (ALT + P).

2.	Choose Exit (ALT + X).

Or click on the ON/OFF button in the upper right hand corner of the desktop.

This will return you to the Windows interface.


Localization

2.3  Localization

Proloc 2.6 for Windows makes your work easier. For example, you can search for text to translate in your source program. In addition, ProLoc will automatically translate any previously translated text and save you a lot of work. The following chapters explain how to localize and translate text, and how to write the program into a different language.


Extract Strings

2.3.1  Extract Strings

To extract text from a program, first open a project. If no project is open, read the information provided in chapter 2.2.3 . For WinProLoc to work correctly, the objects environment settings must be identical to the environment of the file you want to translate. If this is not the case, change the environment settings as shown in chapter 2.2.2 . Otherwise perform the following steps:

1. In the menu bar, choose Localization (ALT + L).

2. Choose Extract Strings from File (ALT + X)

Or click on the Program item on your desktop, choose Extract Strings from File (ALT + X) and then OK (ALT + O).

The Source Program dialog box will appear.

3. Change to the directory you want to use and select a program. Choose OK.

WinProLoc will extract the text from the file and write it to the database. If the file seems not to contain any text, check and change the environment setting of the current project, (see chapter 2.2.2 ). If the end of string of one or more strings is missing, a message will appear after completing this process. You will be asked to view the log file. In this case, see chapter 2.6.2 .

Text with errors will not be included in the database! If the mistakes are not corrected and the strings manually added to the database, these strings will appear untranslated in your new program!


Translate Text

2.4  Translate Text

In order to translate a program into another language, the text has to be translated first. Two options are available to translate the text. Use the translation function included in WinProLoc or convert the database to a text file, translate it and then write it back to the database.


Translation Function

2.4.1  The Translation Function

Open a project as shown in 2.2.4 and perform the following steps:

1.	In the menu bar, choose Localize (ALT + L).

2.	Choose Translate Database (ALT + T).

Or click on the Dictionary item on your desktop, choose Translate Database (ALT + 	T) and then OK (ALT + O).

The dialog box Translation: database name appears. The line Source displays the source text. Enter the translation into the Target box.

The following functions are available:

No translation necessary:

Mark this check box if no translation of the current text is necessary. Then this string will not be written in a textfile if created.

Top: Click on Top to go back to the first string of the database (ALT + T).

Previous: Click on Previous to return to the previous string (ALT+P).

Next: Click on Next to go to the next string (ALT + N).

End: Click on End to go to the last string of this database (ALT + E).

Next New: Click on Next New if some strings in the database are already 	translated and you want to go to the first untranslated string (ALT + W).

Exit: Click on Exit (ALT + X) to exit the translation dialog box.


Translate Text/Textfile

2.4.2  Translate Text Using a Textfile

When not translating the text yourself, or to use another localization tool, WinProLoc lets you create a text file.

Creating Textfile


Create Textfile

2.4.2.1  Create Textfile

To create a text file, perform the following steps:

1.	In the menu bar, choose Localization (ALT + L).

2.	Choose Create Textfile (ALT + A).

Or click on the Textfile item on your desktop, choose Create Textfile and then OK (ALT + O).

The dialog box Creating Textfile appears. Change to a different directory, if necessary, and enter the name for the text file you want to create. Choose OK.

Select one of the following options:

Text file with all records: Creates a text file with all records. Each string must be overwritten during translation.

Text file with new records: Creates a textfile using only the new records. Each string must be overwritten during translation.

Bilingual file with all records: Creates a textfile with all records. Source text is displayed above the target text. Only the target string has to be translated.

Bilingual file with new records: Creates a textfile using only new records. Source text is displayed above the target text. Only the source text has to be overwritten.

Choose OK (ALT + O).


Edit Textfile

2.4.2.2  Edit Textfile

Now you can edit the text file using any word processor. Call the editor in WinProLoc by choosing Localization in the menu bar (ALT + L) and then Edit (ALT + E). Or click on the Edit item on your desktop and choose Edit (ALT+E) and OK (ALT + O).


Update Database

2.4.2.3 Update Database

When finished translating a textfile you have to update the database with the translation. To do this, perform the following steps:

1. From the menu bar, choose Localization (ALT + L).

2. Choose Update Database (ALT + U).

Or click on the Dictionary item on your desktop, choose Update Database (ALT + U) and then OK (ALT + O).

3. Change the directory in the following dialog box, if necessary. Select a textfile.

4. Choose OK (ALT + O).

In the next dialog box specify the type of your textfile: monolingual textfile (automatic with reference) or a bilingual file (always without reference). Select your option and confirm with OK (ALT + O).

This will copy the translation to the current database.


Translating a Program

2.5  Translating a Program

After translating the text you can translate the source program:

1. From the menu bar, choose Localization (ALT + L).

2. Choose Translate Program (ALT + R) and confirm with OK (ALT + O).

Or click on Program, choose Translate Program (ALT + R) and confirm with OK (ALT + O).

3. In the Source Program dialog box, select the source program and confirm with OK.

4. In the Target Program dialog box, enter the name of the target program. Change the directory, if necessary. Confirm with OK.

After completing these steps the program is translated and ready to be compiled. If WinProLoc could not find one or more ends of strings, the original string in the source program will automatically be written into the target program. After completing the translation, a message will be displayed stating that this function was not successfully completed. You will then be asked to evaluate the logfile (see chapter 2.6.3 ).


Applications

2.6  Applications

WinProLoc lets you start some Windows applications directly from WinProLoc.

Reset Database

Fix Database

Evaluate Logfile

File Manager

Notepad

ASCII-ANSI Conversion

ANSI-ASCII Conversion

Changing the Editor


Reset Database

2.6.1  Reset Database

With WinProLoc you can easily translate programs into different languages.

If your database contains the text you need that is not already translated, simply save the project under a different name (see chapter 2.2.5 ). You will have two databases with exactly the same contents to translate into different languages.

If the database is already translated WinProLoc allows you to reset the database to the original language.

To do this, save the project with a different name (see chapter 2.2.5 ). Open the newly created project (see chapter 2.2.3 ), choose Applications from the menu bar (ALT + A) and then Reset Database (ALT + R).

Or click on the Dictionary item on your desktop and choose Reset Database (ALT + R). Confirm with OK (ALT + O).

This will reset the database of the current project into the original language.


Fix Database

2.6.2  Fix Database

You will only need to use this function if an error message is displayed, which says a data string is missing from the database. Canceling functions that have access to the database can result in this error. In this case the index of the database may be incomplete. The Fix Database function rebuilds the index.

To do this, choose Applications from the menu bar (ALT + A) and then Fix Database (ALT + F). WinProLoc will rewrite the index of the database (no message). Or click on the Dictionary item on your desktop. Choose Fix Database (ALT + F) and confirm with OK (ALT + O).


Evaluate Logfile

2.6.3  Evaluate Logfile

If WinProLoc does not find the end of string in the source program while filtering text or translating a program, it will write the line number(s) of the missing string(s) and the contents of the string into a logfile. The translation process will continue and you can use this logfile to find the missing strings and correct the problem at a later time. To evaluate the logfile, choose Applications (ALT + A) from the menu bar and then Evaluate Logfile (ALT + V). Or click on Program, choose Evaluate Logfile (ALT + V) and confirm with OK (ALT + O). The editor will then display the logfile. You will find information about the process in which the error occurred, the files that contain the defective strings, the path, the error type with line number and contents of the string. Using this information, you can easily locate the defective strings in your files.


File Manager

2.6.4  The File Manager

Start Windows File manger by choosing Applications from the menu bar (ALT + A) and then File Manager (ALT + M).

Or click on the Floppy Disk item on your desktop.


Notepad

2.6.5  The Notepad

Start Windows Notepad by choosing Applications from the menu bar (ALT + A) and then Notepad (ALT + N).

Or click on the Notepad item on your desktop.


ASCII -> ANSI

2.6.6  ASCII - ANSI Conversion

You can convert a ASCII formatted file to ANSI format by choosing Applications from the menu bar (ALT + A) and then ASCII->ANSI Conversion (ALT + A).

Select the source file. Confirm with OK. Enter the target file. Confirm with OK. Change the directory, if necessary.


ANSI -> ASCII

2.6.7  ANSI - ASCII Conversion

You can convert a ANSI formatted file to ASCII format by choosing Applications from the menu bar (ALT + A) and then ANSI->ASCII Conversion (ALT + S).

Select the source file. Confirm with OK. Enter the target file. Confirm with OK. Change the directory, if necessary.


Changing Editor

2.6.8  Changing the Editor

Change the word processor by choosing Applications from the menu bar (ALT + A) and then Editor (ALT + E). Enter your editors complete directory path. Confirm with OK.