为转换和导入准备 DITA 内容

运行 Content Importer 前,建议先验证您的 DITA 内容。

过程

  1. 解析所有损坏的交叉引用。
  2. 确保引用的所有主题、映射或图形都可用。
  3. 确保 DITA 主题和映射包含<标题> 元素:这用于 Content Manager 中的 FTITLE 字段。
  4. 运行您想要执行的所有批量操作。
  5. 在已安装 Content Importer 的系统上创建您的 DITA 内容的副本。
  6. 从 DITA 内容的本地副本中删除任何您不想上传的文件。请务必删除所有非 DITA XML 文件。如果运行 Content Importer 时存在此类文件,则会生成错误。

结果

在转换过程中产生问题的最常见验证问题包括:
  • 缺少文件:要导入的 DITA 文件包含对不在要导入的数据集中的文件的引用。您需要添加引用的文件(在引用的位置)或删除引用。
  • 非 DITA 文件:某些文件没有预期的扩展名。您需要将其删除。
  • 不支持 URI 格式:一个或多个<图像> 元素有不完整的标记。提供正确标记或删除图像(及对其的引用)。
  • 存在于@href@Conref@conrefend 属性中的 URI 语法错误:一个或多个引用具有错误的语法。您需要修复或删除它们。有关 DITA URI 语法的更多信息,请访问:DITA 规范 - 基于 URI(直接)寻址
如果您遇到任何这些问题,则需要更正源内容,然后再次运行转换。