#### 44.7.4 Synchronizing graphics settings for HTML output

For HTML output types, check configuration settings for the following options; their values must reflect the destination, not the origin, of graphics to be copied for distribution:

    [Graphics]
    ; StripGraphPath = No (default)
    ;  or Yes (remove path from graphics references)
    ; GraphPath = path to use (replacing any previous) for all graphics
    ; GraphPathOverrides = No (default) or Yes (overrides any path
    ;  in Config markers and in [GraphFiles], adding GraphPath
    ; GraphSuffix = file extension to use for replacement graphics

    [GraphFiles]
    ; Original name (with or without extension) = new name (with
    ; extension); new name overrides any [Graphics]GraphPath specified

    [GraphSuffix]
    ; old suffix = new suffix, overrides [Graphics]GraphSuffix

Note: For JavaHelp and Oracle Help, alternate settings apply; see §20.3.6.2 Letting DITA2Go set up the directory structure and copy files.

The value for GraphPath, if present, is ordinarily a path relative to the wrap directory where the generated HTML files are located. This value is inserted in <img> tags in your HTML output, as references to graphics files on the server; see §32.1 Locating graphics files for HTML. If your configuration file does not include a setting for GraphPath, by default <img> tags do not include a path, unless you specify a path in [GraphFiles] (see §40.2.1.2 Substituting graphics files for HTML).

If WrapPath points to the project directory:

- Set StripGraphPath=Yes
- Remove or comment out any setting for GraphPath
- Set GraphPathOverrides=No (see §40.2.1.3 Overriding path specifications for referenced graphics)
- Make sure [GraphFiles] entries and configuration markers do not include paths.

If WrapPath points to any directory except the project directory:

- Set StripGraphPath=No
- Set GraphPath to point to the WrapPath directory, or to a directory relative to the WrapPath directory
- Set GraphPathOverrides=Yes

See also:

§32.1 Locating graphics files for HTML

§40.2 Replacing and relocating graphics files

§42.2.9.4 Overriding graphic properties for HTML

Previous Topic: 44.7.3 Deleting prior contents of the graphics destination directory

Next Topic: 44.7.5 Synchronizing graphics settings for RTF output

Parent Topic: 44.7 Placing graphics files for distribution

Sibling Topics:

44.7.1 Copying referenced graphics to a distribution directory

44.7.2 Selecting graphics to copy from arbitrary locations

44.7.3 Deleting prior contents of the graphics destination directory

44.7.5 Synchronizing graphics settings for RTF output

Table of Contents • Index