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:

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

Table of ContentsIndex