18.3.9 Locating graphics files for HTML Help

A .chm file can include only files that are located in the same directory as the .hhp file, or in a subdirectory of that directory. If your graphics files are located elsewhere, they must be copied to the .hhp directory or subdirectory. DITA2Go can do this for you.

To tell DITA2Go to fetch your referenced graphics:

[Automation]
WrapAndShip = Yes
CopyOriginalGraphics = Yes

When CopyOriginalGraphics=Yes, DITA2Go follows the file paths in your DITA source to find the graphics files to copy.

To tell DITA2Go where to put copies of the graphics (for example):

[Graphics]
GraphPath = ./graphics

The path you specify for GraphPath should be relative to the wrap directory (see §44.3 Understanding path values for deliverables). This path will be used in HTML output, as the relative path from the HTML files to their referenced graphics. If you use backslashes in the path, DITA2Go converts them to forward slashes before inserting the references in your HTML output. If you specify CopyOriginalGraphics=Yes, DITA2Go copies graphics files to the directory specified by GraphPath, after generating HTML files.

See also:

§18.13 Compiling and testing HTML Help

§32.1 Locating graphics files for HTML

§44.7 Placing graphics files for distribution

Previous Topic:  18.3.8 Regenerating the HTML Help project file

Next Topic:  18.4 Customizing HTML Help display features

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.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

Table of ContentsIndex