DITA 首选项
首选项对话框中的
DITA 类别针对
DITA 文档设置下列首选项:
• DITA 资源管理器 - 为
资源管理器对话框提供以下首选项:
◦ 隐藏元素 ID - 确定 ID 选项是否显示在新建主题选项卡上,以及 ID 是否显示在资源管理器浏览器中。
默认为开。
◦ 插入预览链接文本 - 确定针对 DITA xref 和 link 标记是否在 Arbortext Editor 窗口中插入和显示链接目标的预览文本。
默认为开。
◦ 发出警告的条件是插入超过:xx 个对象 - 确定在单个操作中将超过指定数量的主题引用插入到 DITA 映射中时,Arbortext Editor 是否显示警告对话框。
默认值为 20。
• 其他 DITA 选项 - 提供以下常规 DITA 首选项:
◦ 将新关系表条目自动放入正确的列中 - 确定是否将拖放到 DITA 关系表中的主题引用自动置于与 DITA 主题类型相匹配的表格列中。
默认为开。如果取消复选此选项,则会将主题引用置于放置该引用的列中。
◦ 执行完整性检查期间检查引用文档是否存在错误 - 确定针对 DITA 文档的 增强的完整性检查是否打开引用的文档并对其及当前文档执行增强的检查。
默认为开。
◦ 显示键引用用户界面 - 确定
键和键引用支持的用户界面选项是否显示在
Arbortext Editor 界面中。
默认为开。
◦ 包含“用于编辑的解析文档”视图中的映射 - 确定 DITA 映射的标记是否包含在用于编辑的解析文档中。
默认情况下,解析文档仅包含 DITA 主题。当您使用解析文档的自定义文档类型进行编辑时,此选项不起作用。默认为关。
◦ DITA 引用 — 指定要进行搜索以查找从 DITA 文档中引用的内容的目录列表。
如果未将引用指定为绝对路径名称或相对于当前文档目录的路径名称,则使用 DITA 引用路径。此变量所解析的 DITA 引用包含主题引用、内容引用、链接、交叉引用及引用内容的任何其他 DITA 元素。唯一的一个例外是图形引用,它们使用图形路径进行解析。
初始设置是
APTDITAPATH 环境变量的值(如果设置)。否则,它默认为
Arbortext-path\doctypes\ditamap\ditamapsample 目录。用分号分隔 DITA 首选项路径中的各个目录。 在 DITA 引用路径中可以使用符号参数。
默认情况下,文档目录和当前元素的基础 URI(如果不同)均包含在 DITA 引用路径中的任何目录之前,以对相对引用进行解析。如果有任何 set ditapath 目录参数被设置为 %^ 的值,则在搜索图形时不会将文档目录和当前元素的基础 URI 包括在内。将只搜索指定路径。
◦ 新文档的默认语言 - 确定 Arbortext Editor 将 xml:lang 属性值设置为的默认语言,该属性位于从模板创建的 DITA 映射和主题的根标记上。
请注意,这仅影响创建新文档时尚未设置 xml:lang 的模板。如果未将此首选项设置为某个值,系统将使用与此文档相关联的样式表的默认语言。如果样式表的默认语言为 en,则会使用系统区域设置。默认为 (系统区域设置),这意味着此首选项为空或尚未设置。
此首选项的下拉列表包含以下特殊值:
▪ (默认样式表语言) - 表示使用与此文档相关联的样式表的默认语言。
▪ (无) - 表示不添加任何 xml:lang 值。
不建议采用此值。
▪ (系统区域设置) - 表示使用系统区域设置。
这些值之后为语言代码列表。如果要添加的语言代码不在列表中,可在选项中输入所需代码。但要注意的是,Arbortext Editor 不会检查所输入的代码是否有效。