帮助 > DITA 创作概述 > DITA 支持用户界面 > 键和键引用 > 键和键引用对话框
  
键和键引用对话框
此对话框允许您查看 DITA 映射以及该映射所引用的主题和映射中的键定义和键引用的相关信息。如果当前映射的键上下文被设置为另一个 DITA 映射,则该对话框中的信息针对用作键上下文的映射,而不是当前映射。也可以通过 DITA 主题打开此对话框,但在这种情况下,它仅包含该此主题所含键引用的信息,以及用作当前键上下文的映射中所定义的引用的关联定义的信息。如果对话框收集和显示键信息需要几秒钟的时间,则会显示进度条。
请注意,要使键引用包含有关其键定义的信息,它必须具有活动的键上下文,并且关联的键必须在该上下文中定义。键上下文是包含键定义的 DITA 映射。分配给 ditakeycontext 设置选项的值用于确定文档的键上下文。可以显式设置此选项,在某些情况下,Arbortext Editor 会自动设置此选项。例如,如果从包含键定义的映射打开引用的主题,则该映射会成为键上下文。
可通过工具 > 键和键引用菜单选项来调用此对话框。对于仅在包含光标的标记中定义的键,也可以使用工具菜单和快捷菜单中的查找键引用菜单选项在 DITA 映射中打开此对话框。
键和键引用对话框包含以下选项:
键和键引用信息 - 提供当前文档中有关键定义和关联键引用的信息。
对话框的此区域列出了在映射中定义的键定义,以及在从映射引用的文档中使用这些键的位置。还显示了在当前键上下文中没有关联键定义且在从当前映射引用的文档中定义的所有其他键引用。对于具有定义的键以及键引用,可在树中单击定义或引用将其选择,然后使用转到按钮打开包含该键定义或引用的文档。
对于具有定义的键,键图标为 ,后跟键名称以及定义中 href 属性的值。如果在映射中或者在从映射引用的文档中存在对此键的引用,则这些引用将嵌套在键定义下面。可以折叠和展开键下面的引用列表。包含所列键引用的元素由下列图标指示:
- 表示主题引用 (topicref)。
对于此引用和其他键引用 (keyref 属性中),该图标后面依次为包含键引用的元素的名称、包含该引用的文档的文件名。如果包含该引用的文档位于内容管理系统 (CMS) 中,而不是文件系统中,则其名称为 CMS 对象名称或逻辑 ID。
- 表示交叉引用 (xref) 或link
- 表示image
- 表示内容键引用。
对于内容键引用 (conkeyref 属性中),该图标后面依次为文档中用作内容引用目标的元素的名称、包含该引用的文档的文件名、(conkeyref)
如果键引用没有关联的定义,则键图标将带有红 x ,且后跟键引用中的键名称和 (无定义)。其下方是未定义键的引用,这些引用位于从当前映射引用的文档中。
全部展开 - 展开所列键下方的所有键引用。
全部折叠 - 折叠所列键下方的所有键引用。
转到 - 打开包含所选键定义或引用的文档,并在此文档中突出显示该键定义。
刷新 - 将键定义列表更新为最新状态。