set ditapath=d1 [;dn]

This command specifies a list of directories to search for content referenced by DITA documents when their references do not specify either an absolute path name or a path name relative to the current document directory. Separate each directory in the DITA references path by a semicolon.

You can use symbolic parameters in the DITA references path. The DITA references resolved by this variable include topic references, content references, links, cross references, and any other DITA element that references content. The only exception to this is graphic references, as they are resolved using the set graphicspath option.

The initial setting is the value of the APTDITAPATH environment variable, if set. Otherwise, it defaults to the Arbortext-path\ditarefs directory. If a ditarefs subdirectory exists in either the Arbortext-path\application or Arbortext-path\custom directory, that subdirectory is also part of the default DITA references path.

The base URI for the current element and the document directory, if different from the base URI, are included by default before any directories on the DITA references path to resolve relative references. When any set ditapath directory parameter is set to a value of %^, the document directory and the base URI for the current element will not be included when searching for DITA references. Only the paths specified will be searched.

The DITA references path can also be set in the File Locations category of the Tools > Preferences dialog box.

Examples

A list of multiple directories must be enclosed in quotation marks.

You can use the append_dita_path function to update the DITA references path.