为转换和导入准备 DITA 内容
运行 Content Importer 前,建议先验证您的 DITA 内容。
过程
- 解析所有损坏的交叉引用。
- 确保引用的所有主题、映射或图形都可用。
- 确保 DITA 主题和映射包含
<标题>元素:这用于 Content Manager 中的FTITLE字段。 - 运行您想要执行的所有批量操作。
- 在已安装 Content Importer 的系统上创建您的 DITA 内容的副本。
- 从 DITA 内容的本地副本中删除任何您不想上传的文件。请务必删除所有非 DITA XML 文件。如果运行 Content Importer 时存在此类文件,则会生成错误。
结果
在转换过程中产生问题的最常见验证问题包括:
- 缺少文件:要导入的 DITA 文件包含对不在要导入的数据集中的文件的引用。您需要添加引用的文件(在引用的位置)或删除引用。
- 非 DITA 文件:某些文件没有预期的扩展名。您需要将其删除。
- 不支持 URI 格式:一个或多个
<图像>元素有不完整的标记。提供正确标记或删除图像(及对其的引用)。 - 存在于
@href、@Conref和@conrefend属性中的 URI 语法错误:一个或多个引用具有错误的语法。您需要修复或删除它们。有关 DITA URI 语法的更多信息,请访问:DITA 规范 - 基于 URI(直接)寻址。