##### 20.3.6.2 Letting DITA2Go set up the directory structure and copy files

To have DITA2Go set up the JavaHelp or Oracle Help directory structure for you, specify a path to the top-level directory. For example:

    [Automation]
    WrapAndShip = Yes
    ; WrapPath = for JavaHelp or Oracle Help, path to top-level dir, ;  default is output dir
    WrapPath = ./help

WrapPath can be an absolute path or a path relative to the project directory; the default value of WrapPath is the project directory itself.

Directories are created

When you specify a value for WrapPath, DITA2Go creates the WrapPath directory if it is not already present, and also creates the two required subdirectories, if they are not already present.

To specify names for the subdirectories:

    [JavaHelpOptions] or [OracleHelpOptions]
    ; HTMLSubdir = subdirectory of WrapPath for *.htm, *.css, and *.js
    ;  files, default "html"
    HTMLSubdir = html
    ; GraphSubdir = subdirectory of WrapPath for *.gif, *.jpg, and *.png
    ;  files, default "graphics"
    GraphSubdir = graphics

Unless you are creating a proprietary directory structure, just accept the default names.

The directory designated by HTMLSubdir is the default setting for MapFilePrefix, with “/” appended; see §20.3.6.4 Specifying a path for search-index links.

The directory designated by GraphSubdir is the default JavaHelp and Oracle Help setting for [Graphics]GraphPath, with “../” prepended; see §20.3.6.3 Locating graphics files for JavaHelp and Oracle Help.

Directories can be emptied before copying

To empty the subdirectories before copying:

    [JavaHelpOptions] or [OracleHelpOptions]
    ; EmptyJavaHTMLSubdir = Yes (default, empty HTMLSubdir directory
    ;  before copying) or No (leave HTML files in place)
    EmptyJavaHTMLSubdir = Yes
    ; EmptyJavaGraphSubdir = No (default, leave graphics files in place)
    ; or Yes (empty GraphSubdir directory before copying)
    EmptyJavaGraphSubdir = Yes

Files are copied from the project directory

When you specify a value for [Automation]WrapPath, DITA2Go automatically populates the directory structure. After generating HTML files and optionally creating a full-text search index, DITA2Go copies files that have the following extensions, from the project directory to the directory specified by WrapPath, or to the appropriate subdirectory. For example, with WrapPath=./help and default names for the subdirectories:

Directory | File extensions
    .\help
     *.xml *.hs *.jhm
    .\help\html
     *.htm *.css *.js
    .\help\graphics
     *.gif *.jpg *.png

Note: Files are automatically copied from the project directory only if you specify a value for WrapPath.

List files to copy to the top directory

To specify what files to copy to the top directory:

    [JavaHelpOptions] or [OracleHelpOptions]
    ; JavaRootFiles = list of files to copy to WrapPath
    JavaRootFiles = *.hs *.jhm *.xml

You can use JavaRootFiles to list files to be copied to the directory designated by WrapPath. The file specifications you assign to JavaRootFiles must be separated by spaces, and no spaces are allowed within a file specification. You can use wildcards in file specifications, and include absolute or relative paths to indicate where files should be copied from; the default is from the project directory. By default, the following files are copied:

    *.hs *.jhm *.xml

Any file list you assign to JavaRootFiles overrides these defaults.

Graphics can be copied from a different directory

To have DITA2Go copy graphics files from a location other than the project directory:

    [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 the directory specified by GraphSubdir.

See also:

§16.2.2 Compiling and distributing Help systems.

§44. Producing deliverable results

Previous Topic: 20.3.6.1 Understanding the JavaHelp / Oracle Help directory structure

Next Topic: 20.3.6.3 Locating graphics files for JavaHelp and Oracle Help

Parent Topic: 20.3.6 Creating a directory structure for JavaHelp / Oracle Help

Sibling Topics:

20.3.6.1 Understanding the JavaHelp / Oracle Help directory structure

20.3.6.3 Locating graphics files for JavaHelp and Oracle Help

20.3.6.4 Specifying a path for search-index links

20.3.6.5 Manually copying and deleting output files