18.3.3 Organizing source files for HTML Help

Compiled HTML Help has the following limitation on file placement: a CHM can contain files located only in the same directory as the .hhp file (HTML Help project file) or in a subdirectory. Sibling directories, parent directories, and absolute paths elsewhere do not work. CHM content is organized in an internal file system that duplicates the external file structure, but with the directory containing the .hhp file as the root. Therefore, references to directories outside this structure do not work.

If your project includes DITA files on different paths that reference each other, you might have to reorganize them to conform to this HTML Help limitation. If your project includes referenced graphics files, DITA2Go can copy the graphics files to the project directory (or a subdirectory) before beginning the conversion. See §18.3.9 Locating graphics files for HTML Help.

Previous Topic:  18.3.2 Deciding where to locate configuration settings

Next Topic:  18.3.4 Specifying a project title 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.4 Specifying a project title for HTML Help

18.3.5 Deciding whether to compile 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