Compiled HTML Help (CHM) Output Format
To perform a Compiled HTML Help (CHM) transformation Oxygen XML Editor plugin needs Microsoft HTML Help Workshop
to be installed on
your computer. Oxygen XML Editor plugin automatically detects HTML Help
Workshop
and uses it.
Note
HTML Help Workshop
might fail if the
files used for transformation contain accents in their names, due to different encodings
used when writing the .hhp and .hhc files. If the transformation fails to
produce the CHM output but the .hhp (HTML Help Project) file is already generated,
you can manually try to build the CHM output using HTML Help Workshop
.
Changing the Output Encoding
Oxygen XML Editor plugin uses the htmlhelp.locale
parameter to correctly
display specific characters of different languages in the output of the Compiled
HTML Help (CHM) transformation. The Compiled HTML Help
(CHM) default scenario that comes bundled with Oxygen XML Editor plugin has the
htmlhelp.locale
parameter set to en-US
.
The default value of the htmlhelp.locale
is en-US
. To
customize this parameter, go to Configure Transformation Scenarios and click the
Edit
button. In the parameter tab search for the htmlhelp.locale
parameter and
change its value to the desired language tag.
The format of the htmlhelp.locale
parameter is LL-CC
, where
LL
represents the language code (en
, for example) and
CC
represents the country code (US
, for example). The
language codes are contained in the ISO 639-1
standard and the country codes
are contained in the ISO 3166-1
standard. For further details about language
tags, go to http://www.rfc-editor.org/rfc/rfc5646.txt.