键定义选项卡
键定义选项卡使您可以将键定义插入到 DITA 映射中。如果选择 > 菜单选项，并且资源管理器尚未打开，则资源管理器将打开，同时其键定义选项卡处于活动状态。当编辑映射或映射的专门化时，可在资源管理器中找到此选项卡。ditakeyrefui 高级首选项的设置还用于确定此选项在资源管理器中是否可用。
键定义选项卡具有两种不同的状态。第一种状态用于插入本地文档的键定义。第二种状态用于插入对 Internet 上文档的键定义。另外，所编辑的 DITA 映射的类型将确定该选项卡上可用的选项。如果正在编辑 DITA 键定义映射，则可用的选项较多。
用于插入本地文档的键定义的选项
插入本地文档的键定义时，键定义选项卡包含以下选项：
• 查找范围 - 确定显示在资源管理器浏览器中的内容的位置。
从下拉列表中选择一个位置。该字段始终包含当前在浏览器中可用的位置。双击浏览器中的某文件夹会将该文件夹显示在查找范围字段中。如果在此列表中选择 Web，则键定义选项卡会切换为插入 Internet 文档的键定义的状态。
列表包含
收藏夹位置
选项。选择此选项可将浏览器中显示的位置移动到
收藏夹位置节点，该节点下列出的是您所保存的收藏夹位置。
此列表还包含
历史
选项。 选择此选项可将浏览器中显示的位置移动到
历史节点，该节点下列出的是您在当前会话中访问过的所有位置。
• 菜单按钮 (
) - 显示包含以下选项的菜单：
◦ 打开 (后缀为 Document) - 如果在浏览器中选择了某文档，则可在新窗口中打开该文档。
选择的 XML、DITA、SGML 和 HTML 文档会在新的 Arbortext Editor 窗口中打开。其他类型的文档或图形会在关联的应用程序中打开。例如，图形会在默认的图形应用程序中打开。
◦ 清除历史 – 清除浏览器中历史节点下的已访问位置的列表。
仅当选择历史节点时，此选项才可用。
◦ 添加到收藏夹 - 将所选位置添加至收藏夹位置列表。
仅当在浏览器内选择文件系统文件夹、内容管理系统 (CMS) 文件夹或类似的位置时，此选项才可用。
◦ 从收藏夹移除 - 从收藏夹位置列表中移除所选位置。
仅当在收藏夹位置列表中选择了某项时，此选项才可用。
◦ 上移 - 将收藏夹位置列表中的某项在列表中上移一级。
仅当在收藏夹位置列表中选择了某项时，此选项才可用。
◦ 下移 - 将收藏夹位置列表中的某项在列表中下移一级。
仅当在收藏夹位置列表中选择了某项时，此选项才可用。
◦ 导出收藏夹 - 打开另存为对话框，从中可将当前收藏夹位置保存到 XML 文件中。
仅当在浏览器内选择收藏夹位置节点时，此选项才可用。此选项将收藏夹保存在 XML 文件中，之后可将 XML 文件作为收藏夹列表通过导入收藏夹菜单选项导入。请勿修改此 XML 文件，因为它仅用于保存收藏夹列表。
◦ 导入收藏夹 - 打开打开对话框，从中您可以选择包含导出的资源管理器收藏夹列表的 XML 文件。
仅当在浏览器内选择收藏夹位置节点时，此选项才可用。此选项可导入使用导出收藏夹菜单选项导出的收藏夹列表。
在打开对话框内选择某个文件后，单击打开，即会打开另一个对话框并询问是否与当前收藏夹列表合并或将其替换?，单击合并将导入列表 (该导入列表未在当前列表内) 中的位置添加到收藏夹列表。单击替换将当前的收藏夹列表完全替换成导入列表。
◦ 检出并编辑 – 在 Arbortext Editor 中打开所选 CMS 对象进行编辑。
如果尚未检出该对象，则资源管理器会为您检出 (锁定) 该对象。可以选择在同一操作中检出所有依存对象。此菜单选项仅适用于 PTC 服务器连接 对象。
◦ 检出 - 检出 (锁定) 选定的解锁文档 CMS 对象。
可以选择在同一操作中检出所有依存对象。此菜单选项仅适用于 PTC 服务器连接 对象。
◦ 撤消检出 - 取消检出 CMS 对象并放弃对已检出版本进行的任何更改。
取消检出某个对象后，如果在 Arbortext Editor 中打开该文档对象，它将变为只读。此菜单选项仅适用于 PTC 服务器连接 对象。
◦ 属性 — 显示包含所选对象属性的
对象属性对话框。
此菜单选项仅适用于 PTC 服务器连接 对象。
此菜单选项仅适用于 PTC 服务器连接 对象。可在搜索对话框输入查询，查找与某些搜索条件匹配的所有 CMS 对象。搜索结果显示在资源管理器浏览器的 CMS 搜索结果节点下。
◦ 清除 CMS 搜索结果 - 清除已添加到资源管理器浏览器中的 CMS 搜索结果部分的所有 CMS 对象。
此菜单选项仅适用于支持的 CMS 适配器。 此选项不会从 CMS 移除这些对象，只从资源管理器浏览器中移除这些对象。
◦ 在选项卡之间同步位置 – 确定当您切换到另一个选项卡或打开另一个资源管理器对话框时是否保留在资源管理器浏览器中浏览到的第一个位置。
ditasynctabs 高级首选项的设置确定默认情况下此功能是关闭还是开启。
• 上一文件夹按钮
- 将浏览器中显示的位置移动到已显示在该浏览器中的上一个文件夹。
资源管理器会保留您在当前会话中查看过的文件夹的历史记录，因此您可以使用此按钮通过该历史记录向后查看浏览器视图。如果在当前会话中仅查看了一个文件夹，则会禁用此按钮。
• 向上一级按钮 (
) - 将浏览器中显示的位置移动到当前分层结构中的上一级。
如果您位于分层结构的顶级，则会禁用此按钮。
• 当前文档文件夹按钮
- 将浏览器中显示的位置移动至包含当前文档的文件夹。
• 刷新按钮 (
) - 更新浏览器视图以反映对浏览器中显示的对象所做的任何更改。
• 浏览 Web 按钮
- 将
键定义选项卡切换为插入来自 Internet 的引用的状态。
• 使用 CMS 对象浏览器按钮 (
) - 调用
PTC 服务器连接 或信息库适配器的
浏览器。
只有在您通过 PTC 服务器连接 或信息库适配器连接到内容管理系统 (CMS) 时此按钮才可用。
• 搜索 CMS 按钮
- 调用
搜索对话框。
此按钮仅适用于 PTC 服务器连接 对象。可在搜索对话框输入查询，查找与某些搜索条件匹配的所有 CMS 对象。搜索结果在资源管理器浏览器中的 CMS 搜索结果部分显示。
• 过滤器 - 使您可以过滤浏览器中显示的文件和文档元素列表。
当您在此选项中输入文本时，就会对浏览器中显示的文件和文档元素的列表进行过滤，以只显示标签包含所输入文本的文件和文档元素。在这种情况下，过滤器选项和浏览器会显示浅黄色背景色，来指示正在过滤浏览器的内容。
例如，如果您输入 "test"，则浏览器只会显示标签包含 "Test"、"testing" 以及 "test cases" 等的对象。如果您展开文档以显示文档内部的元素，则还会对显示出的元素进行过滤。在这种情况下，即使标签不包含过滤文本，浏览器中仍会显示该文档。
过滤功能不区分大小写。不会对文件夹和相似的对象进行过滤。如果您在过滤器选项中输入多个条件，则匹配标签必须包含所有这些条件。
• 资源管理器浏览器 — 提供文件系统、内容管理系统 (CMS) 或文档分层结构。
利用资源管理器浏览器您可以查找文件系统或 CMS 中的内容以将其插入到您的文档之中。此浏览器提供文件系统内容或 CMS 内容的层级视图。除显示文件夹和文件之外，您还可以利用浏览器来查看 DITA 文档的内容。例如，使用键定义选项卡时，此浏览器会向您显示 DITA 文档中 (根据文档中的当前上下文) 可作为键定义目标的元素。如果元素的标题可用，则此标题会出现在浏览器中该元素旁边的位置。同时，还会显示元素的 ID (取决于 ditahideids 高级首选项的设置) 以及所有 href 属性值。
如果浏览器中显示的元素在
keyref 属性中已经具有一个键引用值，则将以特殊图标
来指示这一情况。如果在浏览器中选择某个元素，则系统将会自动在对话框的
键属性部分填充某些选项。例如，如果所选元素具有
title 元素，则该元素的内容将会填入
标题选项中。填充的选项取决于所选的元素。
浏览器包含一个
收藏夹位置 节点，该节点包含已保存的收藏夹位置列表。双击某个收藏夹即可在浏览器中打开该收藏夹。如果收藏夹位置当前不可用，例如，如果已删除位置或位置是 CMS 文件夹且未登录到 CMS，则文件夹会有特殊图标
以指示该状态。
此浏览器还包含一个
历史 节点，该节点包含您在当前会话中访问过的所有位置的列表。 双击某个位置即可在浏览器中打开该位置。
单击分层结构中的加号 ( + ) 可打开分层结构或文档内容中的一个级别。单击减号 ( – ) 可关闭一个级别或文档。 单击分层结构中的对象可将其选择。双击文件夹可将浏览器视点移动到该文件夹。
如果在浏览器中双击 Web 节点，则选项卡将切换为插入对 Internet 文档的引用的状态。
• 类型 — 确定显示在资源管理器浏览器中的文档类型。
使用此下拉列表可按文档类型来过滤显示在浏览器中的文档。可选取以下文档类型：
◦ 主题、映射或图像 - 显示 DITA 映射、主题文档或图形文件。
◦ 主题 — 仅显示 DITA 主题文档。
◦ 主题或映射 — 显示 DITA 映射或主题文档。
◦ 映射 — 仅显示 DITA 映射文档。
◦ 图像 — 仅显示图形文件。
◦ PDF — 仅显示 PDF 文档。
◦ HTML — 仅显示 HTML 文档。
◦ 任意 — 显示所有文档类型。
• 显示 — 确定在资源管理器浏览器中为 DITA 文档显示的元素类型。
使用此下拉列表可按元素类型来过滤浏览器中为文档显示的元素。可选取以下类型的元素：
◦ 所有元素
◦ 所有带 ID 的元素
◦ 键定义
◦ 键引用
• 键属性 - 使您可以指定键定义的属性。
使用资源管理器中此部分的选项可以设置所定义的键的属性。可用选项的数量取决于所编辑的 DITA 映射的类型。如果正在编辑 DITA 键定义映射，则可用的选项较多。这些附加选项提供了插入键引用对话框中有关键的更多详细信息。
提供了以下键属性：
◦ 清除 按钮 - 删除已输入到键属性选项中的所有内容。
将内容输入到其中一个键属性选项中时，该选项的标签会变为蓝色。修改了属性内容后，如果在浏览器中更改选择，将不再对该属性进行更新。单击此按钮可清除所有已修改选项的内容、使标签重新变为黑色，并且可恢复所有的默认值。
◦ 名称 - 提供键的名称。
您可以输入一个键名称或多个用空格隔开的键名称。如果在浏览器中选择某个已定义了键引用的元素，则默认情况下，将在此选项中插入 keyref 属性的值。如果输入无效的键名称，此选项的标签将变为红色，并且会在状况栏中显示错误。如果键名称与同一键上下文中的另一个键定义重复，也会在状况栏中显示一条消息。
◦ 标题 - 提供键的标题。
此处的值将被填入键定义的 navtitle 属性中。
◦ 说明 - 提供对键的描述。
此选项仅在您编辑 DITA 键定义映射时才可用。此处的值将被填入键定义的 keydescription 元素中。
◦ 元素·ID - 提供浏览器中所选元素的 ID。
如果所选元素已具有 ID，则默认情况下将在此选项中插入该 ID 的值。如果所选元素没有 ID，则可使用生成 ID 按钮为该元素生成 ID。
此选项仅在您编辑 DITA 键定义映射时才可用。此处的值将被填入键定义中 keysubelementid 元素的 value 属性中。
◦ 生成 ID 按钮
- 为浏览器中所选的元素生成·ID，并更新包含该元素的文档。
此选项仅在您编辑 DITA 键定义映射时才可用。
◦ 引用标记 - 提供了一份参考键的元素列表。
您可以输入一个元素名称或多个用空格隔开的元素名称。根据在浏览器中选择的元素，默认情况下会插入一些元素标记。请注意，要查看标记名称是否有效，请不要复选此字段。
此选项仅在您编辑 DITA 键定义映射时才可用。此处的值将被填入键定义中 keyreftags 元素的 value 属性中。
• 插入 - 确定要插入到映射中的元素类型。
使用此下拉列表可选择要插入到您文档中的元素类型。
• 插入按钮 - 将键定义插入到所编辑的映射中。
如果您文档中的当前上下文不是有效的插入点，则会禁用此按钮。
用于插入 Internet 上文档的键定义的选项
在插入 Internet 上文档的键定义时，键定义选项卡包含以下选项：
• 查找范围 - 确定键定义选项卡的状态。
在插入 Internet 上文档的键定义时，此选项始终设置为 Web。如果从下拉列表中选择不同的位置，则选项卡状态将切换为插入本地文档的定义的状态。
菜单按钮 (
) - 显示包含以下选项的菜单：
◦ 打开 (后缀为 Document) - 已禁用此选项。
此菜单选项仅适用于 PTC 服务器连接 对象。
◦ 清除 CMS 搜索结果 - 清除已添加到资源管理器浏览器中的 CMS 搜索结果部分的所有 CMS 对象。
◦ 在选项卡之间同步位置 – 确定当您切换到另一个选项卡或打开另一个资源管理器对话框时是否保留在资源管理器浏览器中浏览到的第一个位置。
ditasynctabs 高级首选项的设置确定默认情况下此功能是关闭还是开启。
• 上一文件夹按钮
- 将浏览器中显示的位置移动到已显示在该浏览器中的上一个文件夹。
如果在浏览器中上次查看的位置不是 Web，则选项卡状态将切换为插入对本地文档的引用的状态。
• 向上一级按钮
– 此按钮被禁用。
• 当前文档文件夹按钮
- 将浏览器中显示的位置移动至包含当前文档的文件夹。
选项卡的状态将更改为用于修改对本地文档的引用。
• 刷新按钮
– 此按钮被禁用。
• 浏览 Web 按钮 -
此按钮被禁用。
• 使用 CMS 对象浏览器按钮 (
) - 调用
PTC 服务器连接 或信息库适配器的
浏览器。
只有在您通过 PTC 服务器连接 或信息库适配器连接到内容管理系统 (CMS) 时此按钮才可用。
• 搜索 CMS 按钮
- 调用
搜索对话框。
此按钮仅适用于 PTC 服务器连接 对象。可在搜索对话框输入查询，查找与某些搜索条件匹配的所有 CMS 对象。搜索结果在资源管理器浏览器中的 CMS 搜索结果部分显示。
• URL - 显示要为键定义插入的 URL。
您可以编辑此字段以添加所需的 URL，或者选择获取浏览器 URL 按钮将活动 Web 浏览器中显示的网页对应的 URL 插入到 URL 选项中。
• 打开浏览器 – 打开默认的 Web 浏览器。
如果
URL 选项中存在一个 URL，则 Web 浏览器打开时会显示此 URL 对应的网页。请注意，您必须在操作系统或
首选项对话框的
文件位置首选项中设置默认 Web 浏览器，才能使用此选项。
• 获取浏览器 URL – 将活动 Web 浏览器中显示的网页对应的 URL 插入到 URL 选项中。
请注意，您必须在操作系统或
首选项对话框的
文件位置首选项中设置默认 Web 浏览器，才能使用此选项。
• 键属性 - 使您可以指定键定义的属性。
使用资源管理器中此部分的选项可以设置所定义的键的属性。可用选项的数量取决于所编辑的 DITA 映射的类型。如果正在编辑 DITA 键定义映射，则可用的选项较多。这些附加选项提供了插入键引用对话框中有关键的更多详细信息。
提供了以下键属性：
◦ 清除 按钮 - 删除已输入到键属性选项中的所有内容。
将内容输入到其中一个键属性选项中时，该选项的标签会变为蓝色。修改了属性内容后，如果在浏览器中更改选择，将不再对该属性进行更新。单击此按钮可清除所有已修改选项的内容、使标签重新变为黑色，并且可恢复所有的默认值。
◦ 名称 - 提供键的名称。
您可以输入一个键名称或多个用空格隔开的键名称。如果输入无效的键名称，此选项的标签将变为红色，并且会在状况栏中显示错误。如果键名称与同一键上下文中的另一个键定义重复，也会在状况栏中显示一条消息。
◦ 标题 - 提供键的标题。
此处的值将被填入键定义的 navtitle 属性中。
◦ 说明 - 提供对键的描述。
此选项仅在您编辑 DITA 键定义映射时才可用。此处的值将被填入键定义的 keydescription 元素中。
◦ 元素 ID - 此选项被禁用。
◦ 生成 ID 按钮
- 此选项被禁用。
◦ 引用标记 - 提供了一份参考键的元素列表。
您可以输入一个元素名称或多个用空格隔开的元素名称。默认情况下会插入一些元素标记。请注意，要查看标记名称是否有效，请不要复选此字段。
此选项仅在您编辑 DITA 键定义映射时才可用。此处的值将被填入键定义中 keyreftags 元素的 value 属性中。
• 插入 - 确定要插入到映射中的元素类型。
使用此下拉列表可选择要插入到您文档中的元素类型。
• 插入按钮 - 将指定 URL 的键定义插入到所编辑的映射中。
如果您文档中的当前上下文不是有效的插入点，则会禁用此按钮。