插入键引用对话框
此对话框使您可以将键引用插入到 DITA 主题或映射中。您可通过 > 菜单选项或关联的工具栏按钮来调用此对话框。如果需要，可将此对话框停放在 Arbortext Editor 窗口中。
此对话框中包含的键来自 ditakeybaselist 高级首选项中的 DITA 映射。通过使用添加/删除按钮，也可以将映射添加到当前会话的列表中。另外，如果从包含键定义的映射的上下文打开一个主题，则针对该主题打开此对话框时，该映射将成为键上下文的一部分。如果包含键定义的映射是 DITA 键定义映射，则其他信息也可用于这些定义。
插入键引用对话框包含以下选项：
• 搜索 - 使您可以过滤可用的键定义列表。
在此选项中键入内容时，系统将自动对键定义表的内容进行过滤以与键入内容相匹配。搜索范围将覆盖表中键名称、标题/描述以及引用列的内容。在资源列中，还包括所有文本 (包括标注)。
• 区分大小写 - 确定在搜索选项中执行的搜索是否区分大小写。
• 开始于 - 确定在搜索选项中执行的搜索是否只与所搜索列的开头内容匹配。
• 映射 - 确定用于键定义表中的键定义的映射。
默认值全部表示在当前键上下文中使用所有键定义。如果从下拉列表中选择特定的映射，则键定义列表中将仅显示来自该映射的键定义。
使用此对话框可在当前键上下文中添加或删除映射。请注意，这只会更改当前会话中的键上下文。要永久更改键上下文，您必须修改 ditakeybaselist 高级首选项。
• 键定义表 - 列出可作为引用插入到文档中的键定义。
如果包含键定义的映射是 DITA 键定义映射，则其他信息也可用于这些定义。如果对某个键进行了多次定义，则每个定义都会在独立的一行中显示。如果在一个键定义中定义了多个键，则每个键都会在单独的一行中列出。
该表格包含以下列：
◦ 键名称 - 提供键的名称。
常规键不具有图标。内容参考键以
图标表示。如果在 DITA 键定义映射中定义键并且指定
keysubelementid 元素，则该 ID 值将追加到键名称上且位于前导
/ 后。
◦ 类型 - 提供可用于引用此键的元素列表。
如果在 DITA 键定义映射中定义键并且指定了 keyreftags 元素，则键列表将来自该元素。否则，值为任意，这意味着带有 keyref 元素的任何元素均可引用此键。如果键用于内容键引用 (conkeyref)，则值为要用于内容引用的元素的名称，且后跟 (conref)。
◦ 标题/描述 - 提供对键的描述。
如果在 DITA 键定义映射中定义键并且指定了 keydescription 元素，则描述将来自该元素。否则，描述将来自 navtitle 元素、navtitle 属性或 linktext 元素的内容 (按该顺序)。
◦ 资源 - 如果键定义中未提供 href 值，则该列提供键定义中 href 属性的值或者定义中的所有文本，包括标注。
如果键定义中未提供 href 值，则假设定义包含文本替换的内容。
◦ 映射名称 - 提供包含键定义的映射的名称。
表中仅显示映射的基本名称。如果键定义来自从某个映射引用的另一个映射，则显示父映射的基本名称，且后跟用括号括起的引用映射的基本名称。
• 插入下拉列表 - 提供可在当前光标位置处插入的有效键引用元素列表。
对于不用于文本替换的键引用，该列表中的内容由光标所在位置的元素的类型决定。类型列中是否存在一组允许使用的标记和 smartinsert 高级首选项的值也会影响列表的内容。
对于用于文本替换的键引用，列表中显示的元素由 ditatextkeyrefs 高级首选项的值决定。默认情况下，此首选项设置成 off，表示在列表中只会显示允许使用键引用的链接元素。如果该首选项设置成 on，则在列表中同样还会显示允许使用键引用的非链接元素。这使您能够插入用于这些类型元素文本替换的键引用。
• 插入按钮 - 将使用所选元素的选定键引用插入到文档中。
href、scope、type 和 format 属性的值以及键定义中的链接文本可用于所插入的引用。