18.3.5 Deciding whether to compile HTML Help

The HTML Help compiler does not support Unicode, and instead uses code-page mappings. For compiled HTML Help, DITA2Go maps Unicode characters to the correct code page.

If what you need is uncompiled HTML Help files in Unicode, possibly including contents, index, and search files, you can direct DITA2Go not to compile HTML Help:

[Automation]
CompileHelp = No

To omit code-page mapping when you are not going to compile HTML Help:

[MSHtmlHelpOptions]
; UseCodePage = Yes (default, required for CHM compile), or No
; (for use in further processing where other encodings are OK)
UseCodePage = No

To produce Japanese, Chinese, or Korean code-page output, such as for HTML Help in Japanese, you need ICU DLLs: icudt40.dll (13MB) and icuuc40.dll (1MB). These DLLs are available in archive icu401.zip (6 MB), which you can download from the Omni Systems Web site. See:

§1.1.4 Languages and character sets

§18.12 Generating HTML Help in non-Western languages

§18.13 Compiling and testing HTML Help.

Previous Topic:  18.3.4 Specifying a project title for HTML Help

Next Topic:  18.3.6 Naming project and compiled files for HTML Help

Parent Topic:  18.3 Setting up an HTML Help project

Sibling Topics:

18.3.1 Creating an HTML Help project

18.3.2 Deciding where to locate configuration settings

18.3.3 Organizing source files for HTML Help

18.3.4 Specifying a project title for HTML Help

18.3.6 Naming project and compiled files for HTML Help

18.3.7 Specifying a starting topic file for HTML Help

18.3.8 Regenerating the HTML Help project file

18.3.9 Locating graphics files for HTML Help