许多人在使用DITA OT第一发布时会遇到问题。在DITA OT日志信息中，通常问题会提示为“build failed”。但是，你也可能会遇到发布成功，但输出物可能有些问题的情况。以下是一些常见问题的解决措施：
-
命令输出错误。如果发布错误，检查你输入的命令，有无多余的空格、字母有无错位、参数是否齐全，或者其他排印错误。
-
Java版本错误。如果你的Java版本不对，会有日志信息显示发布失败，甚至拒绝运行发布命令。请按照本课之前的指导，安装正确版本的Java。
-
无效的DITA源内容。如果map中某个topic无效，或者map本身无效，DITA OT可能无法发布输出。如果你发布失败，并且日志信息显示于某个源文件有关，打开对应的文件，验证文件结构是否正确。
-
找不到输出物。如果日志显示发布成功，但你找不到输出物，再次确认-o参数，确保你已经指定了输出位置。如果你没有指定，默认输出在DITA OT文件夹下。
-
输出物被替换。每次运行DITA OT，相同命令、相同的参数，但是每次新生成的输出物会替换之前的输出物。如果你想保留每个发布版本（比如，记录每个测试和问题排查的结果），你可以在运行之前重命名前一发布结果，或者每次运行时设置-o参数，指定发布输出的位置。
-
输出物样式错误。有时候，即使发布成功了，输出物的样式却不是预期的的结果。比如，PDF中的图片显示过大，超过页面宽度，或者表格中的列宽不适应文本长度。这些问题是因为在DITA源文件中没有为图片或表格指定规格信息。
为精确控制图片宽度，可以使用<image>元素指定宽度属性。
图 2. PDF输出中，指定了图片宽度 vs. 未指定图片宽度 
对于表格，可以使用<colspec>元素调整表格的列宽，以更好适应文本宽度。
注： 可视化的XML编辑器（例如oXygen）允许通过可视化界面直接调整表格宽度，及直接控制<colspec>的值。
图 3. PDF输出中，调整后colspecs vs. 默认colspecs 
更复杂的问题需要进一步的排查。如果遇到发布失败，确不在上述常见问题之列，请使用DITA OT的日志信息，从头开始分析问题。一旦找到原因，你需要运行更多测试，继续排查问题，直到解决问题。DITA OT日志文件文档（http://www.dita-ot.org/2.4/user-guide/log-files.html）是错误排查良好的指南。
注： 很遗憾，我们无法在这个免费的网站上提供一对一的技术支持。