排查发布错误
发布地图通常非常简单。 打开地图，选择输出预设，然后生成输出！ 但是，如果映射或其主题中存在错误，则输出生成可能会失败。 发生这种情况时，了解如何进行故障诊断非常重要。
为练习做准备
您可以在此处下载练习的示例文件。
发布错误的常见原因
源内容中可能会引入错误。 例如：
-
未正确命名文件路径引用
-
名称错误的文件夹
-
缺少图形或文件
-
内容引用配置不正确
-
中断的交叉引用
-
属性的值错误（例如字符串而不是数字）
-
AEM Guides使用的组件设置不正确
错误的影响
错误可能是轻微的，并导致简单的注释，让您知道文件未成功打包，或者严重到足以导致完全无法生成输出。 “输出”选项卡显示以颜色编码的图标来显示与输出生成相关的成功、错误或失败。
打开并查看错误日志
可以打开生成的日志文件以供审查。
-
在 输出 选项卡中，单击“生成时间”下的 日期/时间
-
滚动浏览错误日志。
显示和隐藏错误类型
错误日志以唯一的颜色显示每种错误类型。
-
选择 或 取消选择 任何错误类型以显示或隐藏突出显示。
-
使用 下一个 或 上一个 按钮（箭头）导航错误。
解决错误
根据错误类型，分辨率可能简单或复杂。 它可以由XML编辑器中的作者完成，也可以要求管理员使用AEM Guides。 具体的更正取决于错误、影响以及您的组织工作流。
-
未正确命名文件路径引用
code language-none 作者可以更新源文档中的路径引用。 -
名称错误的文件夹
code language-none 作者可以根据需要更新文件夹名称或移动文件。 -
缺少图形或文件
code language-none 作者可以上载缺少的图形/文件、重命名图形/文件或移动图形/文件 -
内容引用配置不正确
code language-none 作者可以更正所引用内容的位置，或更改内容引用的路径。 -
中断的交叉引用
code language-none 作者可以更正交叉引用指向的位置，或更改目标文件名或属性 -
属性的值错误（例如字符串而不是数字）
code language-none 作者可以将属性更新为正确的值，或者管理员可以更新系统以支持新值。 -
AEM Guides使用的组件设置不正确
code language-none 管理员可以更新系统、其组件或权限的安装。