帮助 > DITA 创作概述 > 更新 DITA 引用
  
更新 DITA 引用
利用 Arbortext Editor 能够更新 DITA 文档中的所有引用。更新引用操作执行以下更新:
检查并更新 (如果需要) 引用其他文档的 DITA 元素的属性,以确保这些引用为最新
这包括 hreftypeformatscopenavtitle 属性。请注意,此功能不会更新 keyrefconkeyref 属性。
将绝对文件路径更改为基于当前基础 URI、DITA 文档目录以及 DITA 引用路径和图形路径中包括的任何文件夹的相对路径 (如果可能)
更新链接预览文本
可以通过工具 > 更新引用菜单选项更新 DITA 主题或映射的引用。还可以选择部分 DITA 主题或映射,然后通过工具 > 更新所选的引用菜单选项仅针对该部分映射执行更新引用操作。通过右键单击 DITA 主题或映射中的单个元素并从“编辑”窗口快捷菜单中选择更新引用,可以仅更新单个元素的引用。
对于 DITA 主题,仅针对主题执行更新引用操作。对于 DITA 映射,不仅可以针对映射执行更新引用操作,还可以针对从映射引用的任何其他 DITA 映射或主题执行更新引用操作。也针对从原始映射引用的 DITA 映射所引用的 DITA 内容执行更新引用操作。
更新引用操作开始后,消息更新引用: 正在检查 document,已检查 n 个元素将显示在 Arbortext Editor 窗口底部的消息区域中,并随时更新以显示更新引用操作的状态。更新完成后,将显示消息完成了 document 的更新:在具有 n 个元素的 n 个文档中未检查到更改或消息完成了 document 的更新:在具有 n 个元素的 n 个文档中,检查到 n 处更改。在后一种情况下,将出现更新引用消息窗口,列出操作进行的更改以及操作期间检测到的任何警告或错误。每条消息后面都有一个链接。双击链接将光标移动到与消息关联的文档中的相应位置。如果消息与从 DITA 映射引用的文档有关,则在新的 Arbortext Editor 窗口中打开文档。
更新引用消息窗口有两个菜单和一个快捷菜单。
文件菜单具有以下选项:
保存 — 将消息窗口的内容保存为 .xml 文件。 如果这是自窗口打开后的第一次保存操作,会要求您选择输出文件名称。
另存为 — 用其他名称将内容保存到输出。
另存为 HTML — 将内容保存为 .htm 文件。
打印 - 打印消息窗口的发布版本。此打印输出将显示当前由视图菜单设置为显示的信息。
清除前一个 - 除了上次更新引用操作的内容之外,删除消息窗口中的所有其他内容。
全部清除 — 删除消息窗口中的所有内容。
关闭 — 关闭消息窗口。
视图菜单具有以下选项:
代码上下文 — 如果复选此选项,将在消息窗口中显示与问题发生 (如 Java 堆栈追踪) 位置旁的代码相关的上下文信息。
时间戳记 — 如果复选此选项,将在消息窗口中显示时间戳记信息。
消息 ID — 如果复选此选项,则显示与消息条目关联的消息 ID (如果有)。 消息 ID 的一个示例为 A123456
显示 — 确定在消息窗口中显示的内容的类型:
消息 — 显示所有信息(消息、警告和错误)。
警告 — 仅显示警告和错误。这是默认设置。
错误 — 仅显示错误。
字体大小 — 提供了两个选项,用于更改消息窗口中的字体大小:
增大 — 增大显示字体大小。
减小 — 减小显示字体大小。
在消息窗口中单击鼠标右键时,将出现一个快捷菜单。它具有以下选项:
复制 — 将所选区域复制到剪贴板。仅当在所选区域内单击时,此选项才可用。
跟踪链接 — 如果在消息窗口中右键单击一个链接,并且选择了此选项,则将显示所链接的文档,并且光标定位在源文档中的相应位置。 如果在消息窗口中没有链接,则此选项不起作用。
禁止 — 隐藏当前消息。要显示禁止的消息,可选取视图 > 显示 > 消息
折叠/展开 — 折叠或展开当前条目。