#### 44.7.1 Copying referenced graphics to a distribution directory

When you specify WrapAndShip=Yes or designate a WrapPath directory, for HTML output DITA2Go automatically copies graphics files from the project directory to the directory designated by [Graphics]GraphPath; see §32.1 Locating graphics files for HTML. DITA2Go can also copy graphics files from other locations.

To have DITA2Go copy the graphics files referenced by your document to a location relative to the HTML files generated for distribution:

    [Automation]
    ; CopyOriginalGraphics = No (default) or Yes (copy graphics to the
    ; location specified by GraphPath)
    CopyOriginalGraphics = Yes

When CopyOriginalGraphics=Yes, DITA2Go copies graphics from wherever they are referenced by your DITA document to one of the following destinations:

- for JavaHelp and Oracle Help for Java, the directory designated by [JavaHelpOptions]GraphSubdir (see §20.3.6.2 Letting DITA2Go set up the directory structure and copy files)
- for other HTML output types (and DCL output), the directory designated by [Graphics]GraphPath, if any (see §44.7.4 Synchronizing graphics settings for HTML output), otherwise the WrapPath directory
- for RTF output types (and MIF output), the directory designated by WrapPath.

In other words, DITA2Go gathers referenced graphics by following the relevant links in the source document; then, using the values of WrapPath and GraphPath, places those graphics where links in the ready-for-distribution topic files expect to find them.

If your DITA document references graphics files that are in a format not suitable for HTML output, and if you have provided alternates in the same directory with the same file names but a different file extension, you can specify the extension to use for HTML output. See §40.2.1.2 Substituting graphics files for HTML.

Note: If you specify [Automation]OnlyAuto=Yes (see §44.13 Postprocessing separately from converting), and you are relying on CopyOriginalGraphics to get your graphics files into the wrap directory, they will not arrive; graphics files are not copied when OnlyAuto=Yes.

Previous Topic: 44.7 Placing graphics files for distribution

Next Topic: 44.7.2 Selecting graphics to copy from arbitrary locations

Parent Topic: 44.7 Placing graphics files for distribution

Sibling Topics:

44.7.2 Selecting graphics to copy from arbitrary locations

44.7.3 Deleting prior contents of the graphics destination directory

44.7.4 Synchronizing graphics settings for HTML output

44.7.5 Synchronizing graphics settings for RTF output