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