Source Files Dialog Box

Updated: 29. April 2010  (for RC-WinTrans 9)
 

The Source Files property page (see figure below) in the Source and Target Files dialog box displays a list of all the source files contained in the active translation project and offers commands to add or remove a source file to/from the translation project.  The dialog is also used to check the file status of the source files and to update the associated translation database if a source file has changed.

 

The most typical and important reason to use the Source Files property page is to update the translation database when a source file has been modified.

 

Managing a Project's Source Files

Use the Add command button to add (source) files to be translated to the "Source Files" list for the active translation project.  Use the Remove button to remove a file from the project.
 

Use the Align .NET Project Files command button if you want to or if you are translating the RESX resource files of a Microsoft Visual Studio .NET software project.  Clicking on the button opens a dialog box where the RESX files can be aligned with the RC-WinTrans translation project.
 

NOTE  –  RC-WINTRANS TRANSLATOR EDITION:  The Add and Remove commands are disabled for the Translator Edition because this product cannot be used to add or remove files to/from a translation project.

 

Database Update

Use the Update command buttons to update the project's translation data (translation database) for the changed source file(s).  The update can be processed for a single source file (Update selected) or for all of the source files at once (Update all).

 

See also:  "Source File Changes and Database Update."

 

NOTE:  A set of translation data exists in the project's database for each source file and each target language.  Such a set is represented as an item in the "Translation Database" list on the Source Files property page.  Each item in the list represents (1) the current translation data of a given source file and (2) the target language of this data.  If a source file is modified then the corresponding translation data must be updated so that it is current.

 

Changes Preview and Changes Protocols

If a source file has changed the Preview command buttons can be used to generate a preview of the changed data.  An HTML report will be created listing the new, changed, and deleted items.

 

See also:  "Changes Preview Dialog Box."

 

Each time a database update is performed, RC-WinTrans creates a data changes protocol listing the data that has changed in a source file (by comparing it against the existing (current) translation data).  The Protocols command button opens the Project Files Protocols dialog box where any previously generated protocol files are listed (as a history) and where the protocols can be opened and displayed.

 

Figure:  The Source Files dialog box.

 

Controls and Commands

 

Source Files List (Listbox)

Lists all the source files in the active translation project.  The source files are listed once per target language because the changes indication is based on a comparison of the source files and the target language data.

 

Source File Groupbox

Add Button

Opens a dialog box to select and add a source file(s) to the project.

Remove Button

Removes the selected file from the translation project.

Align .NET Project Files Button

Opens the Visual Studio .NET Project dialog box.

 

.Net .snk Key Files Groupbox

Select Button

To select the Strong-Named key file (.snk). The .snk file will be used to sign a target assembly file created for the source assembly.

Remove Button

Removes the .snk file for the selected source assembly.

 

 

 

Change Source File Reference (Local Menu) Command

To change the file reference (file name and/or path) of the selected source file right mouse-click to open a local menu with this command.
 

Translation Database Listbox4

Each item in the listbox represents (1) the current translation data of a given source file and (2) the target language of this data.
 

Update Database Groupbox

Update selected Button

Updates the translation database of the selected source file.

Update all Button

Updates the translation database for all the source files and all the target languages.

Force update for unchanged source files Checkbox

Selecting this option forces an update of the translation data even if the no changes are detected/indicated.  If the option is unchecked RC-WinTrans will only update the translation data if the source file has been marked as changed.

 

Changes Groupbox

Preview Button

Generates a changes preview for the selected source file by comparing it to the existing translation data.

Protocols Button

Opens the Project File Protocols dialog box where a history of previously generated protocol files are listed and where the protocols can be opened and viewed.

 

 

File Status and Translation Database Status

There are several different file statuses that can appear in the "Data Status" and "Update Data Status" columns of the Translation Database Files listbox.  Please refer to the table below for their meanings.

 

STATUS TEXT

DESCRIPTION

changed

The source file has been modified.  The corresponding translation database file must be updated.

exists

The source file exists and is up-to-date (unchanged).

does not exist

The source file does not exist.

 failed

Operation failed.

 successful

Operation successful.

 

Symbols

 

Indicates that the source file exists and that it has not been changed.

Indicates that the source file does not exist or is not up-to-date, or failure of the translation data update.

Delay-Signed .Net assembly file.

Strong-Names Signed .Net assembly file.