HTML Files


SPECIAL NOTE ON HTML RESTRICTIONS: RC-WinTrans does not support HTML files in general.  We handle HTML files that are used in software as part of the graphical user interface (e.g., HTML dialogs).  These HTML files are less complex than HTML documents that are used on the Web or in HTML help systems.


There is no guarantee that an HTML file can be translated with RC-WinTrans.  The translation of HTML files is a not fully-supported feature.  We intend to improve the HTML support continuously in order to increase the possibilty of translating HTML files, but in the immediate future there will always be HTML files that cannot be processed by RC-WinTrans.


In conclusion:

The translation of HTML files is a not fully supported feature of RC-WinTrans.

HTML document files (Web HTML documents) are not supported at all.

HTML help files (e.g. from Macromedia RoboHelp) are not supported at all.


RC-WinTrans uses a file converter to convert HTML files to XLIFF files so that they can be translated using RC-WinTrans.  The converter converts HTML files to the XLIFF file format and the translated data in an XLIFF data file to a target HTML file.


NOTE FOR DEVELOPERS:  Technically the converter is realized (implemented) as a COM object and used in a Visual Basic "converter" macro (macros file: "SystemMacros"; module: "ConvHTML").


The converter can extract and write back the following content to and from HTML files:

the document title.

the encoding used for the file (e.g., Windows-1252).

all text content below the <body> element.

attribute and style values within HTML elements (e.g., font and size settings, hyperlink targets, etc.).


Documents that are to be used with the HTML converter should conform to the HTML specifications. Some documents with an irregular structure (e.g., an <h1> element within a <strong> element) cannot be processed at all.


Script, CSS code outside HTML elements, or other non-HTML-code is not handled by the converter- it will only work with HTML code that is part of the HTML DOM when loading the document.


The converter handles images that are loaded with the HTML document; consequently it is also possible to localize images as well.  By default, images are stored as part of the XLIFF representation of an HTML file (internal storage).  In the case of large or repeated images, however, the converter can be configured to only store the references to image files (external storage).


When writing a translated HTML file the image files will also be written.  In order to accomplish this, image files must be referenced locally.  Typically, an image file should be referenced relative to the HTML file, as in <img alt="image" href="image/pic1.jpg">.


NOTE:  The HTML converter only processes documents with images that are loaded using the file:// protocol (as opposed to the http:// protocol which is not currently supported).


See also:  "File Converters."