内容引用选项卡
内容引用选项卡使您可以将内容引用插入到 DITA 主题和 DITA 映射中。如果选择 > 菜单选项,并且资源管理器尚未打开,则资源管理器会打开,同时其内容引用选项卡处于活动状态。对于 DITA 映射,内容引用选项卡将显示在单独浮动的资源管理器对话框中。
如果当前未为您要作为内容引用插入的元素分配一个 ID,则会为此元素生成一个 ID(如果您拥有对源文件的写访问权限)。如果您的文档中目前不存在有效的引用元素,资源管理器会自动将一个新的空元素插入到您的文档中,作为内容引用的目标。在您编辑主题、映射或者主题或映射的专门化时,此选项卡在资源管理器中可用。
内容引用选项卡包含下列选项:
• 查找范围 - 确定显示在资源管理器浏览器中的内容的位置。
从下拉列表中选择一个位置。该字段始终包含当前在浏览器中可用的位置。双击浏览器中的某文件夹会将该文件夹显示在查找范围字段中。
该列表包含
收藏夹位置 选项。选择此选项可将浏览器中显示的位置移动到
收藏夹位置节点,该节点下列出的是您所保存的收藏夹位置。
此列表还包含
历史 选项。 选择此选项可将浏览器中显示的位置移动到
历史节点,该节点下列出的是您在当前会话中访问过的所有位置。
• 菜单按钮 (
) - 显示包含以下选项的菜单:
◦ 打开 (后缀为 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 高级首选项的设置确定默认情况下此功能是关闭还是开启。
• 上一文件夹按钮
- 将浏览器中显示的位置移动到已显示在该浏览器中的上一个文件夹。
资源管理器会保留您在当前会话中查看过的文件夹的历史记录,因此您可以使用此按钮通过该历史记录向后查看浏览器视图。如果在当前会话中仅查看了一个文件夹,则会禁用此按钮。
• 向上一级按钮 (
) - 将浏览器中显示的位置移动到当前分层结构中的上一级。
如果您位于分层结构的顶级,则会禁用此按钮。
• 刷新按钮 (
) - 更新浏览器视图以反映对浏览器中显示的对象所做的任何更改。
• 当前文档按钮
- 以浏览器视图打开当前文档。
• 使用 CMS 对象浏览器按钮 (
) - 调用
PTC 服务器连接 或信息库适配器的
浏览器。
只有在您通过 PTC 服务器连接 或信息库适配器连接到内容管理系统 (CMS) 时此按钮才可用。
• 搜索 CMS 按钮
- 调用
搜索对话框。
此按钮仅适用于 PTC 服务器连接 对象。可在搜索对话框输入查询,查找与某些搜索条件匹配的所有 CMS 对象。搜索结果在资源管理器浏览器中的 CMS 搜索结果部分显示。
• 过滤器 - 使您可以过滤浏览器中显示的文件和文档元素列表。
当您在此选项中输入文本时,就会对浏览器中显示的文件和文档元素的列表进行过滤,以只显示标签包含所输入文本的文件和文档元素。在这种情况下,过滤器选项和浏览器会显示浅黄色背景色,来指示正在过滤浏览器的内容。
例如,如果您输入 "test",则浏览器只会显示标签包含 "Test"、"testing" 以及 "test cases" 等的对象。如果您展开文档以显示文档内部的元素,则还会对显示出的元素进行过滤。在这种情况下,即使标签不包含过滤文本,浏览器中仍会显示该文档。
过滤功能不区分大小写。不会对文件夹和相似的对象进行过滤。如果您在过滤器选项中输入多个条件,则匹配标签必须包含所有这些条件。
• 资源管理器浏览器 — 提供文件系统、内容管理系统 (CMS) 或文档分层结构。
利用资源管理器浏览器您可以查找文件系统或 CMS 中的内容以将其插入到您的文档之中。此浏览器提供文件系统内容或 CMS 内容的层级视图。除显示文件夹和文件之外,您还可以利用浏览器来查看 DITA 文档的内容。例如,在使用内容引用选项卡时,此浏览器会向您显示 DITA 文档中(根据该文档中的当前上下文)可作为内容引用的元素。元素类型、元素内容的简要摘录以及元素的 ID (取决于 ditahideids 高级首选项的设置) 也显示在浏览器中。
如果正在浏览包含键定义的 DITA 映射的内容,则可展开该映射,并且键定义由键图标
指示。仅当键定义在
format 属性中的值与当前文档相同时,它们才会显示在浏览器中。您可以展开键定义,以显示键所引用的文档中的标记。如果选择键定义中的标记,则键名称将被插入到
Conkeyref 选项中。如果在选择了键定义中的标记的情况下插入引用,则会针对插入的内容引用设置
conref 属性和
keyconref 属性的值。
ditakeyrefui 高级首选项的设置用来确定此选项在
资源管理器浏览器中是否可用。
浏览器包含一个
收藏夹位置 节点,该节点包含已保存收藏夹位置的列表。双击某个收藏夹即可在浏览器中打开该收藏夹。如果收藏夹位置当前不可用,例如,如果已删除位置或位置是 CMS 文件夹且未登录到 CMS,则文件夹会有特殊图标
以指示该状态。
此浏览器还包含一个
历史 节点,该节点包含您在当前会话中访问过的所有位置的列表。 双击某个位置即可在浏览器中打开该位置。
单击分层结构中的加号 ( + ) 可打开分层结构或文档内容中的一个级别。单击减号 ( – ) 可关闭一个级别或文档。 单击分层结构中的对象可将其选择。双击文件夹可将浏览器视点移动到该文件夹。双击某个文档元素可将对该元素的内容引用插入到您的文档中。
可使用以下方式将对浏览器中显示内容的引用插入到您的文档中:
◦ 突出显示某个元素,并选择插入按钮
◦ 双击某个元素
◦ 使用拖放操作
• 类型 — 确定显示在资源管理器浏览器中的文档类型。
使用此下拉列表可按文档类型来过滤显示在浏览器中的文档。可选取以下文档类型:
◦ 映射 — 仅显示 DITA 映射文档。
◦ 映射或主题 — 显示 DITA 映射或主题文档。
◦ 主题 — 仅显示 DITA 主题文档。
◦ 任意 — 显示所有文档类型。
• 显示 — 确定在资源管理器浏览器中为文档显示的元素类型。
使用此下拉列表可按元素类型来过滤浏览器中为文档显示的元素。
• Conkeyref - 使您可以有选择地输入要插入到引用的 conkeyref 属性中的键引用。
需要将内容键引用添加到所插入的引用中时,可使用此选项。ditakeyrefui 高级首选项的设置用于确定此选项在资源管理器中是否可用。对于浏览器中所选的对象,如果有一些键是在 ditakeycontext 或 ditakeybaselist 高级首选项中所设置的其中一个定义映射中指定的,则默认情况下,这些键将显示在下拉列表中。
• 插入 — 将对所选文档元素的引用插入到您所编辑的文档中。
如果您文档中的当前上下文不是有效的插入点,则会禁用此按钮。