帮助 > DITA 创作概述 > 对 DITA 文档执行完整性检查
  
对 DITA 文档执行完整性检查
Arbortext Editor 扩展了常规检查完整性功能,为 DITA 文档提供增强的完整性检查。创作 DITA 文档时若选择工具 > 检查完整性或单击检查完整性工具栏按钮,将首先对文档执行常规完整性检查。常规完整性检查完成后,Arbortext Editor 针对 DITA 特定问题执行增强的完整性检查。之后会在完整性检查日志中报告所有问题。如果执行增强的完整性检查需要几秒钟的时间,则会显示进度条。
常规完整性检查检查可以使用与文档关联的文档类型进行验证的问题。增强的完整性检查检查 DITA 标准中有规定但不能根据 DTD 或 XML 方案进行验证的问题。例如,增强的完整性检查可检查丢失的文件、不正确或异常的 URL 格式,异常的 formattype 属性值、使用已废弃的元素或属性等等。
可以对 DITA 主题或映射执行增强的完整性检查。对于 DITA 主题,仅针对主题执行增强的完整性检查。根据 ditacheckreferences 高级首选项的设置,对于 DITA 映射,不仅会对映射执行增强的完整性检查,而且还会对从映射引用的任何其他 DITA 映射或主题执行增强的完整性检查。也针对从原始映射引用的 DITA 映射所引用的 DITA 内容执行增强的完整性检查。还可以选择部分 DITA 映射,然后仅针对该部分 DITA 映射执行增强的完整性检查。在这种情况下,针对整个映射执行常规完整性检查,但仅针对所选映射部分执行增强的完整性检查。
增强的完整性检查开始后,消息开始增强的完整性检查… 将显示在 Arbortext Editor 窗口底部的消息区域中。检查进行时,此消息显示增强的完整性检查的状态。检查完成后,将显示消息完成增强的完整性检查: 没有错误/警告或消息结束增强的完整性检查: 详细信息请参阅消息窗口。在后一种情况下,将出现完整性检查日志窗口,列出在文档中检测到的任何与 DITA 相关的警告或错误。每个错误或警告在其关联的消息后面都有一个链接。双击链接将光标移动到检测到错误或警告的关联文档中的相应位置。如果错误或警告与从 DITA 映射引用的文档有关,则在新的 Arbortext Editor 窗口中打开文档。
增强的完整性检查可检查以下类别的与 DITA 相关的问题:
DITA 标注问题 – 如使用已废止的标注、按文档类型未选中的无效属性值以及使用仅用于专门化的标记等问题
DITA 引用问题 - 如无效的 href 属性值、异常或错误的 format 属性值以及 type 属性值等问题
请注意,检查 format 属性所用的值由 ditaexpectedformats 高级首选项的设置确定。
DITA 键和键引用问题 – 与键和键引用相关的问题,如未定义的键引用、无效的键定义名称以及解决 conkeyref 引用时出现的问题等
完整性检查日志窗口有两个菜单和一个快捷菜单。
文件菜单具有以下选项:
保存 — 将消息窗口的内容保存为 .xml 文件。 如果这是自窗口打开后的第一次保存操作,会要求您选择输出文件名称。
另存为 — 用其他名称将内容保存到输出。
另存为 HTML — 将内容保存为 .htm 文件。
打印 - 打印消息窗口的发布版本。此打印输出将显示当前由视图菜单设置为显示的信息。
关闭 — 关闭消息窗口。
视图菜单具有以下选项:
显示 — 确定在消息窗口中显示的内容的类型:
消息 — 显示所有信息(消息、警告和错误)。
警告 — 仅显示警告和错误。这是默认设置。
错误 — 仅显示错误。
字体大小 — 提供了两个选项,用于更改消息窗口中的字体大小:
增大 — 增大显示字体大小。
减小 — 减小显示字体大小。
在消息窗口中单击鼠标右键时,将出现一个快捷菜单。它具有以下选项:
复制 — 将所选区域复制到剪贴板。仅当在所选区域内单击时,此选项才可用。
跟踪链接 — 如果在消息窗口中右键单击一个链接,并且选择了此选项,则将显示所链接的文档,并且光标定位在源文档中的相应位置。 如果在消息窗口中没有链接,则此选项不起作用。
折叠/展开 — 折叠或展开当前条目。
增强的完整性检查有以下限制:
对于 DITA 映射,只对映射执行常规完整性检查,而不对从原始映射引用的任何 DITA 主题或映射执行常规完整性检查。
不针对从其他主题引用的 DITA 主题执行增强的完整性检查。
对于包含大量主题引用的 DITA 映射,完成增强的完整性检查所需的时间可能比完成常规完整性检查的时间长。