Administration > Environment Variables > Symbolic Parameters in Path List Variables
Symbolic Parameters in Path List Variables
You can choose any of the following symbolic parameters when setting path list variables:
%B — Refers to the directory in which the current document is found. You can use this variable to add relative paths to a path list. For example, to add peer graphics directories to your graphics path, the directories could be referred to with the following form:
%H — Refers to the Arbortext Editor installation directory. For example, if Arbortext Editor is installed in c:\Program Files\PTC\Arbortext Editor, then %H expands to that directory.
%D — Refers to the default path list for a variable. For example, the default catalog path is the doctypes subdirectory of %H and the default graphics path is the graphics subdirectory of %H. You can specify the %D option at the end of the list to ensure the default path is included in the list.
%L — Refers to the current locale. If you are specifying a path that varies across locales, you can use %L to find a file in the associated locale-specific subdirectory for your current locale. For example, the default location for several formatting and font configuration files is the appropriate locale-name subdirectory of %H\lib\locale. As an example, if you want to specify a path that works on both a Japanese and a Korean locale (Arbortext-path\lib\locale\jpn and Arbortext-path\lib\locale\kor), you could specify %H\lib\locale\%L.
The %L parameter is resolved using the rules for the locale_file_name function. In particular, if a file is not found in lib\locale\%L, Arbortext Editor looks for it in lib\. Unlike the %D and %H parameters, you may also use %L in path names outside path lists, for example, in system identifiers in the right hand side of catalog entries.
%^ — Indicates to exclude some default directories from the path list and only search the explicitly specified directories. For the graphic files, the parent document directory is excluded from the path. For entities, the parent document directory and current working directory are excluded from the path. For DITA references, the document directory and the base URI for the current element are excluded from the path.
You can use these variables when setting the paths for the Preferences > File Locations dialog box, for various set command options, or many of the Arbortext environment variables.
When setting a path list variable in a batch (.bat) file, you must precede the percent sign with another one so that substitution characters are not treated as DOS variables. For example:
set APTCHENTPATH=%%D;%%H\lib\
You can avoid the manual steps to specify or append paths and environment variables by placing custom files of many types in the Arbortext-path\custom directory.