Adding/Enabling an XML File Converter

 

This topic is obsolete as of January 2007.  Please refer to the RC-WinTrans Developer Help Topic "XML Parser."

 

This topic describes the process of adding an XML file converter to the RC-WinTrans X8 system so that it will recognize and support the translation of a certain XML file format.  In order to do this you must already have a pair of XSLT transformation files which are used by RC-WinTrans to process (read and write) an XML file.

Requirements

There are two requirements for adding an XML file converter:
 

1.

A pair of XSL transformation files for a particular XML file format.

The first XSL transformation file is used to transform the XML file to an XLIFF file, the second to transform the translated XLIFF file to an XML file.

2.

The name of the XML document root element.

To find the name of the XML document element, use a text editor (e.g., Notepad) to open one of the XML files to be translated. The document element can be found at the top of the file (Figure 1a and 1b).

 

Figure 1a:
An XML document.  The name of the XML document-root element is highlighted
(here: "
Ressourcen").

 

 

Figure 1b:
An XML document.  The name of the XML document-root element is highlighted
(here: "
xx:root").

 

 

Enabling the XML Converter

 

Copy the two transformation files to disk.


Copy the two transformation files (.XSLT, .XSL) to the following RC-WinTrans installation folder:

    "<installation path>\RC-WinTrans X8\Templates\Transform\"

 

Example for two XSL transformation file names:

      nod32ToXliff.xsl    (nod32 XML  ->   XLIFF)

      XliffToNod32.xsl    (XLIFF  -> nod32 XML)
 

NOTE: The transformation files do not have to be copied to the RC-WinTrans installation folder- they can be placed anywhere on the disk.

 

Open the XML Files Converter  dialog box.


From the Tools menu, select the Options command to open the
Options
 dialog box. Then select the File Converters property page.
Next click on the "XSLT XML Converter" button to pen  the
 XML Files Converter dialog box (Figure 2).

 

Figure 2:  How to open the XML Files Converter dialog box.

 

Specify the new XML file converter.


Click on the Add Type button on the XML Files Converter page (Figure 3). The XML Files Converter page will display a group box for you to enter in the XML file data and XSLT transformation file names (Figure 4).

Figure 3:
The Add Type button on the XML Files Converter page.

 

Converter data (Figure 4):

a short descriptive name for the XML file type.

the root element of the XML file (XML document root element) (see "Requirements," above).

the XSL transformation file (XML -> XLIFF) that converts the XML file type to the XLIFF format used internally by RC-WinTrans.

the XSL transformation file (XLIFF -> XML) that converts the translated XLIFF file back into the source XML file format.

Figure 4: The group box for entering the XML file data and XSLT transformation file names located at the bottom of the XML Files Converter page.

 

 

Add the converter.


Once you have entered in all the necessary information, press the OK button (Figure 4) to accept it and enable the converter. The name of the new XML file converter is now listed on the XML Files Converters page (Figure 5) and can be used to process the XML file(s).

 

You can now go on to add the XML file(s) to a translation project, translate it/them in RC-WinTrans, and create a translated target XML file of the same type.

 

Figure 5:
The
XML Files Converter page showing the newly added XML file converter ("NOD32 XML Setup File").