文件位置首选项
首选项对话框中的
文件位置类别用于设置多个可设置为路径列表的首选项的路径。 对于此类别中的大部分首选项,可以使用
编辑首选项对话框来修改文件位置的列表。 打开此对话框的方法是单击要修改的首选项旁边的
按钮。
可以设置以下文件位置路径:
• 目录 - 指定搜索 catalog 文件的目录列表。
目录 可解析实体和文档类型的公共标识符。默认路径为
doctypes 子目录。
对于可以指定的目录数量没有限制;但是,在图形中所允许的最大字符数为 4095。
初始设置是 APTGRPATH 环境变量的值 (如果设置)。否则,它默认为 Arbortext-path的 graphics 子目录。如果 graphics 子目录存在于 Arbortext-path\application 或 Arbortext-path\custom 目录中,则该子目录同时也是默认图形路径的一部分。使用 %D 引用 Arbortext-path\graphics 目录和 Arbortext-path\custom 目录中的任意 graphics 子目录。
默认情况下,任何基础 URI 和文档的父目录(如果与基础 URI 不同)均包含在为查找图形而搜索的目录中。如果有任何 set graphicspath 目录参数被设置为 %^ 的值,则在搜索图形时不会将父文档目录包括在内。将只搜索指定路径。如果要将当前工作目录包含在图形路径中,请在目录列表中添加一个句点 ( . )。但建议您不要将当前工作目录包含在图形路径列表中,因为这样会导致结果不一致。
• 实体 — 指定一个目录列表,用于搜索未经绝对路径名或相对于当前目录的路径名指定的
文件实体文件。
必须添加所有目录,因为 Arbortext Editor 不自动搜索所列出的目录的子目录。
实体选项中列出的目录可以为 file://、http:// URL 以及文件路径。可以指定任意数量的目录。但是,实体路径中所允许的最大字符数为 4095。
默认情况下,在文档目录和当前工作目录中搜索实体文件。但是,在搜索实体文件时,可以指定一个 %^ 值来忽略父文档目录和当前工作目录。将只搜索指定路径。
• 浏览器 — 指定 Arbortext Editor 将要使用的默认 HTML web 浏览器的路径和文件名。
如果在 Windows 上设置了与 web 浏览器的文件关联,则 Arbortext Editor 将自动检测到该关联。请注意,单击此首选项旁边的按钮将打开打开对话框,可在其中查找所需的浏览器。
• DITA 引用 — 指定要进行搜索以查找从 DITA 文档中引用的内容的目录列表。
此选项在编辑
DITA 文档时使用。如果未将引用指定为绝对路径名称或相对于当前文档目录的路径名称,则使用 DITA 引用路径。此变量所解析的 DITA 引用包含主题引用、内容引用、链接、交叉引用及引用内容的任何其他 DITA 元素。唯一的一个例外是图形引用,它们使用
图形路径进行解析。
初始设置是
APTDITAPATH 环境变量的值(如果设置)。否则,它默认为
Arbortext-path\doctypes\ditamap\ditamapsample 目录。用分号分隔 DITA 首选项路径中的各个目录。 在 DITA 引用路径中可以使用符号参数。
默认情况下,文档目录和当前元素的基础 URI(如果不同)均包含在 DITA 引用路径中的任何目录之前,以对相对引用进行解析。如果有任何 set ditapath 目录参数被设置为 %^ 的值,则在搜索图形时不会将文档目录和当前元素的基础 URI 包括在内。将只搜索指定路径。
| 文档类型、图形和实体可位于 Arbortext-path\custom 的子目录中。custom 子目录路径自动前置于默认路径。 |